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Raspberry Pi 3 B+ finds a new 
home 


Versatile enclosure for Raspberry Pi 3 B+ 

The new UCS-RPI Universal Case System is compatible with the recently launched 
Raspberry Pi model 3 B+. It has pre-milled side walls for easy access to the I/O and 
power inputs and is available in black or grey and two sizes. Complete with glue dot 


location posts to secure the single board computer to the case. 


For additional information call 0845 881 2222 or visit 
phoenixcontact.co.uk/UCS-RPI 


DGD OO GD GD OGD OO OD Likcncc OCDE 


INSPIRING INNOVATIONS 


‘Welcome 


WEOME DD —— 
THE OFFICIAL 
MAGAZINE Bde 


aking video games is a rite of passage for 
most programmers. Children of all ages 
learn through play, and we can think of few 
better ways to spend the day than making our own 
video games. 
The Raspberry Pi is ideally suited to the creative 
side of video gaming. Its small, hackable nature 
makes the Pia hands-on affair. 
Our favourite computer contains enough modern 
technology to run games like Minecraft while 
encouraging you to muck around with your own code. SUBSCRIBE 
Ever since the dawn of computing, there have 
been tools and techniques to help budding video 
game developers. Early coders had to make it up as 
they went along (you still can), but there’s no need 
to feel so alone these days: there are a lot of tips for 
designing and making playable games. 


Above all else, the Raspberry Pi has a community. THIS MONTH: 
So you can share your games with other people and 
feedback hem. 
ee cians 06 GOOGLE EDGE TPU ACCELERATOR 


We think gaming is an integral part of the ; 
computing experience and is especially important Speed up Al neural networks running on a Raspberry Pi 


for younger and newer coders. So this month’s 24 MAKE GAMES WITH RASPBERRY PI 


big feature is all about gaming: how to design and 
: Design, develop, and share your own video games 
create your own games, and share them with other 


SEE PAGE 34 FOR DETAILS 
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Shouting doesn't cut it with everyone 


> AUTOMATE PI WITH CRON 54 


Schedule tasks on your Raspberry Pi 
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Make the screen move with your character 
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Measure environmental factors with Rust 


FORMULA PI 


Start your engines! 


A processor for Al Brand new challenge 


Some of the tools and techniques shown in The MagPi magazine are dangerous unless used with skill, experience, and appropriate personal protection equipment. While we 
attempt to guide the reader, ultimately you are responsible for your own safety and understanding the limits of yourself and your equipment. Children should be supervised. 
Raspberry Pi (Trading) Ltd does not accept responsibility for any injuries, damage to equipment, or costs incurred from projects, tutorials or suggestions in The MagPi 
magazine. Laws and regulations covering many of the topics in The MagPi magazine are different between countries, and are always subject to change. You are responsible 
for understanding the requirements in your jurisdiction and ensuring that you comply with them. Some manufacturers place limits on the use of their hardware which some 
projects or suggestions in The MagPi magazine may go beyond. It is your responsibility to understand the manufacturer's limits. 
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AIY EDGE TPU 


ACCELERATOR 


Google announces TensorFlow Lite booster for Raspberry Pi 


Below The 
stylish Edge 
TPU Accelerator 
measures just 
65 x 30mm 


oogle has revealed the AIY 
Edge TPU Accelerator with 
support for Raspberry Pi. 
The small USB dongle attaches 
to a Raspberry Pi to increase the 
speed of running machine learning 
(ML) models. 


6 | MagPi September 2018 


These models use a previously 
trained neural network to create 
predictions, such as the next 
word in a sentence, or what object 
is in an image. The Edge TPU 
Accelerator makes it a whole lot 
faster to perform this prediction on 
a Raspberry Pi. 

The AIY Edge TPU Accelerator is 
designed to act as a neural network 
coprocessor for your Raspberry 
Pi 3 board, massively speeding 
up the process. 

These devices “represent our 
first steps towards expanding 
AIY into a platform for 
experimentation with on-device 
machine learning,” says Billy 
Rutledge, Google’s Director 
of AIY Projects. 

The AIY Edge TPU Accelerator 
is designed with mounting holes 


Above The tiny Google Edge TPU chip is 
designed to accelerate machine learning 
inferencing on devices like the Raspberry Pi 


The chip itself measures 
25mm square and runs machine 
learning models locally. The chip 
provides a vastly improved speed 
performance over using just a CPU, 
and at a low power cost. 

This first generation of the Edge 
TPU is designed to run predictions 
on pre-built models — it does not 


We know that performance- 
per-watt and performance- 
per-dollar are critical 


to attach to a Raspberry Pi board 
and uses a standard USB-C socket 
to connect. Google says that the 
device will be available “this fall 
in the US with other countries 

to follow.” The price is yet to be 
announced (magpi.cc/vROTII). 


Edge TPU 

The Google Edge TPU (Tensor 
Processing Unit) is a new 
purpose-built application-specific 
integrated circuit (ASIC) chip 
designed to accelerate TensorFlow 
Lite ML inferencing. 


support training. The models can 
be trained on desktop computers 
or much larger machines such as 
with Google Cloud. 

The presence of the TPU will 
enable a Raspberry Pi to execute 
previously trained neural network 
models much faster. 


TensorFlow Lite 

The Edge TPU is designed 

to work with TensorFlow 

Lite (magpi.cc/tflite), a new 
lightweight ML solution for mobile 
and embedded devices like the 
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AlY EDGE TPU 
ACCELERATOR 
SPECIFICATIONS 


ML accelerator: 
Google Edge TPU coprocessor 


Connector: 
USB Type-C’* (data/power) 


‘Compatible with Raspberry Pi boards 
at USB 2.0 speeds only 


Dimensions: 
65mm «x 30mm 


Supported operating 
systems (on host CPU): 
Debian Linux, Android Things 


Supported frameworks: 
TensorFlow Lite 


Raspberry Pi. It features a set of 

core operators that have been fine- 

tuned for mobile devices. 
TensorFlow Lite supports 

a number of models, such as 

Inception V3 (used for detecting 

the dominant objects present 

in an image) and On Device 

Smart Reply (which is used 

to make smart replies to text 

messages — it first appeared on 

smartwatches). See here fora 

complete list of supported models: 

magpi.cc/tfmodels. Developers 

can also create their own models 

for TensorFlow Lite. 


High performance 

“We know that performance-per- 
watt and performance-per-dollar 
are critical benchmarks when 
processing neural networks within 
a small footprint,” says Billy. 

He explains: “The Edge TPU 
delivers both in a package that’s 
smaller than Lincoln’s head on 
a US penny. It can accelerate ML 
inferencing on a device or can 
pair with Google Cloud to create 
a full cloud-to-edge ML stack. In 
either configuration, by processing 
data directly on-device, a local 
ML accelerator preserves privacy, 
removes the need for persistent 
connections, reduces latency, and 
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Models - Chromium 


D5: //Blyprojects withgoogle com 


allows for high performance using 
less power.” 

It’s early days for machine 
learning on devices like Raspberry 
Pi, and it will be exciting to 
see how small boards with 
advanced machine learning 
techniques can be used to solve 
real-world problems. 

Typical examples suggested 
by Billy include “maintaining 
equipment reliability, detecting 
quality control issues in product 


Above The Edge TPU ' 
Accelerator attaches to 

a Raspberry Pi via USB-C 

to improve machine 

learning inference 


VISION KIT VOICE KIT 


FACE DETECTOR 


LEARN MORE 


DOG / CAT / HUMAN DETECTOR 


LEARN MORE 


DISH CLASSIFIER 


LEARN MORE 


lines, measuring retail foot-traffic, 
[and] building adaptive automotive 
sensing systems.” In addition, 
we’re sure you’ ll all find plenty of 
unique uses for it. 
We’re excited by the AIY Edge 
TPU Accelerator and can’t wait to 
take a look at it. More information 
can be found on the AIY Projects 
website: magpi.cc/edgetpu. 


EDGE TPU 


MODELS HELP 


Above Machine 
learning models 
for AlY kits are 
available on the AIY 
Projects website 
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ROARS] 


Live-streamed races and 
self-righting cars make for Al 
thrills for Rosie Hattersley 


You can purchase entry to Formula Pi (Winter 2018) 
races via the PiBorg website (magpi.cc/oLKiFR). 
Entry is £37 and you don't need a robot or any other 
equipment (all race robots are provided by PiBorg, 
so everybody uses the same race design - all you 
need to supply is code). 

Along with your entry into the race series, you 
will receive in the post a Yeti-Lid to decorate. This 
is returned and attached to your car (So you can 
identify it in races). 

Take a look at the standard race code online at 
magpi.cc/hEJNsP. Entrants edit and update this 
code to win the race. Code is sent to Formula Pi 
via FTP and uploaded to a robot. Racers watch the 
race online with all the other competitors. 

“We have some amazing things lined up for 


the coming seasons,” says Tim Freeburn. “Please 


support the project and help make autonomous 
racing accessible to everyone!" 
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Image credit Conor Ballard 
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ormula Pi has been 

showing off its latest 

Raspberry Pi-powered 
self-driving robot cars ahead 
of a Kickstarter campaign that 
aims to take autonomous racing 
mainstream (see magpi.cc/jjcVzD). 

Unlike almost every other form 

of motorsport, this form of track 
racing isn’t prohibitively expensive 
for ordinary folk to get involved 
with. Formula Pi race director Tim 
Freeburn says competitors “do not 
require a large budget or their own 
robot to compete, with the cost of 
entry being about £37 (just $50).” 
Formula Pi even provides basic 
example code to get you started, 
which you can then adapt to 
improve racing performance. 


Competitive racing 
Formula Pi was showcased at the 
Raspberry Fields festival at the 
end of June, where cars with the 
new Raptor chassis were shown 
cruising round a broadly triangular 
track. While a great proof of 


GEAR 


concept for autonomous driving, 
the smooth running demonstrated 
at Raspberry Fields only touched 
on the cars’ true abilities. To be 
really impressed you need to follow 
the Formula Pi competitive race 
season. Here, Al cars primed with 
team-customised code go head- 
to-head, avoiding collisions, taking 
the racing line, self-righting, and 
rebooting in a bid to complete the 
most laps in ten-minute heats. 

The MagPi got trackside access 
to a Formula Pi race at owner 
PiBorg’s Cambridge HQ, where 
we were able to watch three heats 
involving five second-generation 
YetiBorg AI cars. 

The races are recorded 
automatically using multiple 
cameras around the race track. 
Contestants around the world 
log in to watch the live-streamed 
event at formulapi.com, and post- 
race analysis can be viewed on 
YouTube at magpi.cc/KuYzfT. 

Live telemetry on each car is 
broadcast, along with its track 
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Competitors design custom 
Yeti-Lids for their Al cars 


position. And live commentary 

is provided by PiBorg developer 
Claire Pollard (@thetuftii). Coder- 
owners join in with a live chat as 
the races take place. The overall 
result is a highly automated global 
race where code wins the day. 


Distinguishing marks 

Cars are distinguished by their 
different coloured lights and by 
the owner-designed ‘lids’ — metal 
tags that screw on to the otherwise 
identically specced vehicles. 
Custom code is sent to Formula Pi 
via FTP or, occasionally, an SD card 
in the post. 

PiBorg and Formula Pi director 
Tim Freeburn tells us that in the 
first competitive season of YetiBorg 
Al racing, entrants simply made 
their cars “as fast as possible, 


88119811 
98118188 


with results akin to those in Crash 
Bandicoot.” For the 2018 season, 
competitors had to add crash 
avoidance to their Raspberry Pi 
code. The effectiveness of this new 
rule was in full effect at the Formula 
Pi track in Earith, just outside 
Cambridge, where we witnessed 


it’s likely that some of PiBorg’s 
club cars will be employed as 
Static obstacles, along with any 
competitors that develop faults. 
At present, competitors can initiate 
a reboot code for ‘stalled’ cars. 

The middle of the race track 
already has nods to TV show 


up laps 


A highly automated global 
race where code wins the day 


groups of five cars dashing round 
the track at top speed and, mostly, 
avoiding each other. 

As with Formula One, the rules 
change from season to season. 
Presently, vehicles that crash or 
are entangled become obstacles for 
the other racers. For future races, 
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Commentator Claire Pollard 
introduces racers and 
checks their race stats 


Robot Wars, with mini versions 
of Matilda, Sir Killalot, and 

the turntable obstacle from Pi 
Wars (magpi.cc/ZWvFVH). In 
time, these props will become 
interactive — the windmill’s sails 
already turn - and may become 
additional obstacles. 


Faster cars 

Autonomous vehicles competing 
in the 2018 race season are twice 
the speed of the first generation of 
Formula Pi cars and can complete 
a lap in around 15 seconds. The 
yet-to-be-launched Raptor models 
are faster still, lapping in around 
seven seconds. Speed aside, what’s 
likely to really appeal are the 
customisable moulded chassis, 
designed by engineers at Rolls- 
Royce, which make the racers 
seem like ‘real’ cars. So if you want 
to get into competitive racing in 
which it’s your code that gives you 
the edge, Formula Pi looks like the 
high ‘oct-Al-ne’ way to go. 
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COMPUTER 
LITERACY 
ARCHIVE 


The 1980s was a golden era for home computing. 
Let’s explore it all over again, says Rosie Hattersley 


f you’ve ever wanted to know more about 

the history of British home computing, a 

whole treasure trove of interviews, TV shows, 
programming code, and photos has been assembled for 
your delectation and inspiration. The BBC has launched 
an archive of its Computer Literacy Project (CLP). 

This delightful archive of home computing and 
information technology (magpi.cc/nqHDem) includes 
all146 TV programmes from a ten-year endeavour that 
began 36 years ago. 


The BBC Micro was a major 
influence on the creation 
of the Raspberry P1 


Interviews with heroes of technology and personal 
computing — including Microsoft co-founder Bill 
Gates, Apple’s Steve Jobs and Steve Wozniak, and 
Apricot’s Roger Foster — are all now accessible from 
the BBC’s Computer Literacy Project Archive. 

Launched back in 1982, the BBC’s Computer 
Literacy Project was intended to inspire and 


Back in 1982, the Acorn-built BBC Micro computer launched as a means 
of allowing home users to explore programming and coding. Homes 
and schools quickly bought into the personal computing revolution, with 
many of today's most ardent computer fans citing the BBC Micro and its 
BASIC language as their first programming experience. 

You can easily install BBC BASIC on your Raspberry Pi. Open a Terminal 
and enter: 


sudo apt-get update && sudo apt-get upgrade 
sudo apt-get install brandy 


Then enter brandy at the command line to open the Brandy Basic V 
Interpreter. Note that you will need to use CAPS LOCK to enter BBC BASIC 
code, as you need to type every command in capitals. 
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The Computer Literacy 

Project Archive brings together 
all of the original 146 CLP shows, 
plus 121 related programmes 


EXEMS Computer Literacy Project 


encourage a whole generation of coders and 

home computing enthusiasts. The impetus for 

its launch was a critical Horizon documentary 

in 1978 that suggested a ‘lack of awareness and 
competitiveness’ in the UK that meant Britain was 
likely to miss out on the social and economic benefits 
of microelectronics. 

Such was the success of BBC Education’s CLP 
and the BBC Micro home computer (among others) 
that, says Hermann Hauser, co-founder of Acorn 
Computers, “Britain [was] the most computer 
literate nation on Earth at the time and with the BBC 
computer created a generation of UK programmers 
who have become leaders in their field.” 

The BBC Micro was a major influence on the 
creation of the Raspberry Pi, which was designed to 
capture the coding heyday of the 1980s and increase 
the number (and quality) of students applying to study 
computing at Cambridge University. 

Eben Upton, Raspberry Pi co-founder, told The 
Centre for Computing History (magpi.cc/EOMrxz): 
“The first computer I owned was a BBC Micro.” The 
initial idea for the Raspberry Pi arose from talking 
about redoing the BBC Micro (as a response to MIT 
planning an Apple II clone). 


Computing history 

The original BBC TV shows are bound to fascinate 
anyone investigating the UK personal computing 
evolution for the first time, while evoking nostalgia 
in those who remember the 1980s BBC Computer 
Literacy Project. 
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4 instrumental in teaching 
5 -S Tre computing in British schools. 
(Credit: Marcin Wichary, 
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The archive came about due to the difficulty for , ™ 
academics and technology historians to easily access > D INrP late 
treasures from the CLP. While the TV footage and 
interviews have been recovered, radio shows broadcast 
under the CLP banner appear to have been lost. Th e Si mM ple way to aarele nt yo ur pj! 

Many of the TV shows make for interesting viewing —_—_—— 
from a present-day perspective. In May 1980, The a es ore 


Silicon Factor (magpi.cc/crbMPk) getting a paint- E é 
spraying robot in a car factory to memorise the actions 7 Ind ustrial DIN rail mount 


involved in writing a name on a sheet of paper was 7 Open frame for better airflow 
round-breaking. “The memory is recording eve F : 
: ica ae eee - Integrated USB strain relief 


single unsteady movement of the pen,” explained 
presenter Bernard Falk before showing the robot 
accurately reproducing his writing. 

Meanwhile 1988’s Electric Avenue issued rather 
prescient warnings about data sharing and 
theft: magpi.cc/JziPxO. 

Mainly, however, the archive is about showing the 
possibilities and ideas of digital pioneers. As with 
the original CLP resources, BBC chief technology and 
product officer Matthew Postgate says the Computer 
Literacy Project Archive is “a unique resource for 
teaching and learning that will hopefully encourage 
a new generation of computer users.” 


The 
Discover how to turn a Raspberry RETRO 
NG 


Pi into a functioning BBC Micro COMPUT] 
(and lots of other old computer Se "SS 
systems) in issue 67 of 
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RETURNS 
TO THE STARS 


Take your code to the International Space 
Station and beyond, urges Rosie Hattersley 


he European Astro participants for its two missions: by writing computer programs 

Pi Challenge, an ESA 1500 for Mission Space Lab that will be run on Raspberry Pi 

Education project run in and 5300 for Mission Zero, the computers aboard the ISS. 
collaboration with the Raspberry majority from secondary school. For Mission Space Lab, teams 
Pi Foundation, is gearing up forits This year, the European Astro Pi first submit their experiment 
next mission. From 12 September Challenge aims to attract at least ideas — no code is required yet. 
until 26 October, Astro Pi will 7500 participants. The teams with the best ideas 
be accepting applications from are then sent an Astro Pi kit 
space fans keen to impress ISS Get your code into spdqce including a Raspberry Pi with 
astronauts with their ideas and The aim of the European Astro both an infrared camera anda 
coding prowess. Part of the Astro Pi Challenge is to encourage Sense HAT, plus a microSD card 
Pi Challenge, Mission Space Lab schoolchildren to conduct and instructions on (optionally) 
is a four-phase experiment aimed scientific investigations in space 3D-printing your own case. 


squarely at secondary schools and 
older primary school pupils. ' ' ' 
The European Astro Pi Astro Pl will be accepting 


Challenge is an annual science and 


programming challenge where applications from space fans 


student-written programs are 


run on the International Space keen to impress ISS astronauts 


Station. Last year it had 6800 


Once your team’s code is 
approved, it is sent up to the 
International Space Station where 
your experiment is run on the 
ISS Astro Pi computers for three 
hours. Participating teams receive 
a download of the data for their 
experiment and a photo of where 
the ISS was when their experiment 
was taking place. Finally, students 
write up a scientific report about 
the experiment they conducted. 

The teams submitting the 
ten best entries will receive a 
special certificate. 

The Astro Pi Challenge is open 


Astronaut 
to entrants from ESA member and Tim Peake using a 


Image credit: ESA associate member states. For more ire wed # a 
(European Space Agency) i on ’ e Internationa 
details, visit astro-pi.org. Space Station 
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GREEN TOWER 


An aeroponics tower that uses a Raspberry Pi to grow some tasty veg 


» The tower has 
been five years 
in the making 
Water is pumped up to 
> The project misters inside the tower 
uses a custom to water the plants 
HAT board 


» It's what's 
known asa 
‘vertical farm’ 


> Water is 
delivered to 
the plants 
as mist 


» The system 
repurposes a 
motor for door 
locks, a water To make the most use of 
pump from an vertical space, the veg grows 
RV, and more out of the side of the tower 


A Raspberry Pi controls 
the whole operation 


>) 
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s healthy eating becomes 
more and more popular, 
a greater number of 
people want to grow their own 
vegetables. The problem is, not 
everyone has a nice garden or 
allotment to grow their own 
stuff - enter hydroponics and, 
specifically in Chris Johnson’s 


The consistently poor quality of 
the lettuce finally provided the 
push to begin the project 


case, aeroponics: the process 
of growing plants in an air or 
mist environment. 

“For the last five years I have 
been designing and refining an 
aeroponics tower system that is 
particularly well suited to growing 
leafy green vegetables,” Chris 
tells us. “The goal is to designa 
computer-controlled, modular, 
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LITTLE GREEN TOWER 


"* (c) 2018 - 
Spiroponics - 


compact, and low-cost aeroponic 
system that is easy to replicate.” 
The idea came to him while 
browsing through some 
‘particularly bad lettuce’ while 
shopping. “I had always been 
interested hydroponics,” Chris 
explains. “The consistently poor 
quality of the lettuce finally 


provided the push to begin 
the project.” 

All the years of work have paid 
off and, as you can see overleaf, 
Chris has been growing plenty of 
leafy green veg. 

“A neighbour told me that 
the kale was the best that they 
had ever had,” Chris says. “I 
personally am not a kale fan, 
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Projects 


Left The 
SpiroBoard, 

created by Chris 

for the project, 
monitors pH, 
electroconductivity, 
air temperature, 
and water 
temperature, as 
well as controlling a 
motor for the pump 


Below It’s a long 
way from soil and 
a watering can, but 
you should just 
taste the results 


y 
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Below Who would 
have thought 

such an industrial 
setup could create 
something so tasty? 
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so I'll have to take her word for This will also reduce the cost 

it. The green leaf lettuce is far to reproduce the system: “[It’s] 
superior to what I was getting in printed with PETG, the same thing 
the grocery store. The best partis used to make two-litre drink 


that you pick leaves as you need bottles, since it is food-safe, same 

them and the rest of the plant as all the hoses and fittings. The 

just keeps on growing.” water pump is actually a standard 
Chris says that the main issue RV/caravan water pump.” 

still to overcome is algae growth A Raspberry Pi 3 powers the 

in the water. “I am working to system, with regular upgrades 

mitigate that with different plastic made to the Pi part of it. “I use 

and also different fertiliser. the webiopi web interface program 


To reduce algae, the plastic should 
be opaque so that the algae inside 
the system gets no light to grow 


Green-leaf vegetables need to provide the backbone for the 
copper and copper kills algae, so system and the control software is 
I will soon be testing a fertiliser written in Python,” reveals Chris. 
that contains the required trace “T use the pigpio library for the [?C 
amounts of copper. To reduce 1/O and to control the waveform 


algae, the plastic should be opaque __ timing for a custom controller 
so that the algae inside the system _ board that I designed to work 
gets no light to grow. Standard with the Pi.” 

white filament, needed for its light You can find out more details 
reflectivity, is not opaque enough. on the Hackaday project page, 


Iam looking to get a filament which Chris is in the process 
extruder so that I can make my of updating at the time of 
own more opaque filament.” writing: magpi.cc/RarKVA. 


Above After four 
weeks, lettuce 
can be seen 
growing well! 


Left It's more 
spaceship survival 
pod than English 
country garden, 
aesthetically 


So 
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_ ALEX SCHWARZ 


Alex Schwarz is an 
amateur radio enthusiast 
with a particular interest 
in space weather. 
magpi.cc/uldOgt 


WEATHER 
STATION 


Alex Schwarz uses the Raspberry Pi as part of an effort to better observe 
and predict the effects of space weather. David Crookes grabs an umbrella 


The Pi helps 
with space 
weather 
predictions 


RF- 
Seismograph 
monitors up 
to six different 
bands 


It checks the 
NOAA space 
weather alert 
system 


24-hour 
monitoring is 
made possible 


Measurement 
graphics are 
uploaded to 
aweb server 


f you want to know what 
the weather is like, then 
some would suggest you 
look out of the window. But that 
only works if the weather you’re 
after is immediately outside. 
Should you want to know what’s 
happening elsewhere — in space, 
perhaps — then you’ll have to get a 
little more technical. 

Alex Schwarz has done just 
that, developing a real-time space 
weather station which he now runs 
on a Raspberry Pi 3. It makes use of 
two well-established amateur radio 
software packages called the MDSR 
and RF-Seismograph, as well as 
some serious hardware including 
a huge antenna that can be many 
metres in height. These allow 
for real-time spectrum analysis 
and long-term propagation 


The Raspberry Pi 3 is fitted with 
a Fe-Pi Audio V1.4 24/16-bit 
sound card 


To simplify the setup of the 
unit, a Buck power regulator 


is implemented to reduce the 
13.8V to 5V for the Pi 


The LIF-2016 converter allows 
an existing transceiver to be 
used, ensuring the signal can be 
processed using the sound card 
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monitoring by detecting particular 
noise changes that point to 
specific happenings. 


Listen up 

To explain, propagation 
monitoring detects the behaviour 
of radio waves as they travel from 
one point to another in various 
parts of the atmosphere. As such, 
the idea is that the weather station 
is able to ‘listen in’ for changes 
in natural space phenomena such 
as the solar wind and the Earth’s 
magnetic field. 


This is then interpreted by the Pi 
and its installed software, allowing 
a graphical representation of the 
weather to be noted. By constantly 
monitoring the input, it’s possible 
to view patterns and match them 
to phenomena. So far, the space 
weather station has picked up 
on a build-up of energy in the 
troposphere; at least two hours 
before the storm hit, it was possible 
to view the extent of the lightning 
strikes. It has also detected 
propagation from meteorite trails. 
“Now we know how a meteorite 
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SPACE WEATHER STATION 


RUNNING THE WEATHER STATION 


>STEP-01 


looks on the RF-Seismograph and 
it will enable us to spot more, even 
during the day,” Alex says. 

It really is an impressive feat, 
especially considering Alex and his 
fellow amateur radio enthusiasts 
wrote the RF-Seismograph 
software themselves. “We 
believe it has great potential to 
increase the understanding of the 
ionosphere [the ionised part of 


It was originally designed 
to measure the solar eclipse 


Earth’s upper atmosphere] and 
how it protects life on this planet,” 
Alex tells us. “It was originally 
designed to measure the solar 
eclipse last year, but in the process 


tabla exten 


| duration of storm | all monitored bands are open 


Above This image shows the results of a 

thunderstorm as seen through the space 
weather centre, with the lightning spikes 
clearly visible 
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we discovered the software is also 
perfect to measure and show how 
short-wave radio propagation 
changes over time.” 


Sounding off 

The Raspberry Pi has certainly 
come to the rescue. Initially, the 
software had been running on 
Windows and Linux, but Alex 
and his friends wanted a way of 


lowering costs. “The Raspberry Pi 

3 is fast enough and so we decided 
to move all our software over to 
Raspbian,” Alex says of the switch. 
“The RF-Seismograph runs a little 
slowly on the Pi so there’s room for 
improvement, but it’s a lot simpler 
and cost-effective in comparison to 
PCs. The OS is also stable, it’s easy 
to install, and the add-on hardware 
looks classy.” 

The hardware for this project 
included a sound card with stereo 
line input for picking up the sound 
waves that are created in the 
receiver. By scanning the receiver 
across six different short-wave 


>STEP-02 


mx Solar Radiation 
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bands, changes can be monitored 
and identified. In order to get the 
raw signal from the receiver, the 
LIF-2016 converts radio waves to 
sound waves that the audio card can 
process. The higher the quality of 
the sound card input, they figured, 
the better the results for the 
received and demodulated signal. 
For convenience, a seven-inch 
touchscreen was also added and 
the whole setup was connected to 
the transceiver — the device that 
connects to a large shortwave 
antenna and picks up the signal for 
the Pi to process. “The software is 
capable of sharing this information 
with the world by including an 
FTP server that uploads every ten 
minutes to the web,” Alex adds. 
“So that is how we keep our website 
automatically current. It’s certainly 
been worthwhile.” 


>STEP-03 
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Above A diagram 
showing the 
different layers of 
Earth's atmosphere 
detectable 

by the space 
weather station 
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Within the portable case are 
Eneloop batteries powering the Pi, 
camera, and thermal printer - they 
deliver a constant voltage 


The camera's rudimentary output 
is limited by the doodle data of 
Google's Quick, Draw! project 


» Draw This 
uses a neural 
network to 
recognise 
objects 


» Images are 
matched with 
doodles from 
Quick, Draw! 


» The doodles 
are printed like 
ona Polaroid 
camera 


» The Quick, 
Draw! dataset 
costs nothing 
to download 


» The entire 
dataset takes 
up just 5GB 
of space 


The Raspberry Pi 3 is wired 
up to a shutter button as 
well as toa status LED 


Dan Macnish wants to help people overcome fears about deep learning 
and artificial intelligence by using a camera that turns photos into 
cartoons. David Crookes strikes a pose 


e all know how cameras 

work. You line up your 

shot, fiddle with the 
focus, set the shutter speed, and — 
flash! — you get a perfect image of 
whatever is in front of you. With 
Dan Macnish’s camera, however, 
the process and results are a little 
different. Instead of outputting a 
faithful photograph, it attempts 
to turn what it sees into a cartoon 
doodle, instantly spitting it out 
on to thermal paper like a quirky 
Polaroid picture. 

To do this, it makes use of two 
key components: a neural network 
and the dataset produced by 
Google’s online game Quick, Draw! 


20 | MagPi September 2018 


(quickdraw.withgoogle.com). 
The game is similar to Pictionary 
in that it suggests an object to 
sketch, with the twist being that it 
then uses AI to predict what you’ re 
attempting to scribble. The result 
has been more than 50 million 
doodles, and Dan’s device seeks to 
match one of them with whatever 
the neural network reckons has 
just been snapped. 
It’s all rather eye-catching. “I 
got the idea while experimenting 
with some of the amazing open 
source research into neura 
networks,” Dan tells us. “There are 
some great projects coming out of 
this research, but many of them 


re focused on neural networks 
hemselves, rather than simple 
pplications for these networks. 

O my project originated as a 
uper-fun, simple application for 
his research, to be enjoyed by all 
orts of different people — not just 
ngineers and developers.” 


a 


anaAn 


on 


Cartoon camera 

As such, Dan was keen to keep 
things simple, fun, and whimsical, 
and he soon got down to work. He 
began with some basic sketches 
and ideas focusing mainly on what 
the user experience would be. 
“Through these initial sketches, I 
set on the idea of a Polaroid camera 
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that draws cartoons, without ever 
showing the original image,” he 
says. “I particularly focused on 
the emotions and feelings that 
people might have: their surprise 
when seeing a cartoon and the 
excitement of not knowing what it 
would look like.” 

At the same time, he began 
prototyping the software using 
Python and Jupyter Notebook on 


My project originated as a 
Super-fun, simple application 


his laptop. He ran a pre-trained 
network over a few photographs 
before manually browsing the 
Quick, Draw! dataset and hand- 
selecting images which he then 
copied and pasted together in 
Paint. “These quick prototypes 
led me to flesh out the software 
and I moved on to an integrated 
development environment (IDE). 
Once I was getting good results on 
the laptop, I transitioned the code 
to the Raspberry Pi.” 


Pi-cture this 
At the heart of the device is an 
internet-connected Raspberry 


>STEP-01 


Press the button 


Although there is a Lens at the front of the 
casing (a v2 Camera Module), there is no 
viewfinder around the back. You simply 


Pi 3 running Raspbian Stretch 
on a16GB card, with a v2 
Camera Module, outputting toa 
thermal printer, all housed ina 
simple cardboard casing. When 
an attached shutter button is 
pressed, the software interprets 
what it sees as one of 345 
doodles and outputs them. 

“The neural network I used can 
only recognise a small fraction of 


\! 
the categories in the Quick, Draw! 
dataset,” Dan explains. “So there 
are still many possibilities for 


ve Some results are stranger than others. Dan's food ina 
Japanese cafe was turned into an American hotdog, while some 
selfies have replaced humans with dogs 


Low Dan used some efficient Python code released by Google 
to interface with the individual drawings 


using this dataset that have not 
yet been imagined.” 

Even so, the response has been 
hugely positive. “People love 
the concept and it’s great seeing 
their reactions to some of the 
funny cartoons that appear,” he 
says. “One of the most surprising 
things is that even when the 
camera prints something 
completely incorrect, people often 
interpret the cartoon in a way that 
makes it seem correct after all. It’s 
quite entertaining.” 
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>STEP-O 


Time for processing 


When the shutter button is pressed, the 
status LED lights for two to three seconds 
as the Raspberry Pi processes the image. 


power up, aim, and press the shutter 
button on top. 
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The Quick, Draw! dataset covers hundreds of 
objects, from forks to faces, beards to bears. 


>STEP-03 

Printing a picture 

Dan says the lack of a screen and the 
inclusion of a thermal printer enhances 
the experience. “There is a fantastic 
feeling of anticipation as the image slowly 
appears from the printer,” he says. 
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Projects 


Hoverbot cost 
only around 
$250 to build 


It can run for 
4+ hours ona 
battery charge 


A60-LED strip 
is used for 
illumination 


Hoverbot 
features a 
webcam and 
speaker 


Code and build 
details are at 
magpi.cc/ 
PMnvo0i 


SHOWCASE 


ISABELLE SIMOVA 


Isabelle enjoys tinkering with 
electronics, but this is the first 
project she has open-sourced. 
magpi.cc /CDEbOq 


An IKEA tabletop; other 
table sections were 
upcycled for the body 


An LED strip provides 
animated lighting effects 


Hoverboard-sourced 


wheels are supplemented 
by castors 


OVERBOT 


A robot made from a hoverboard and an old table? 
Nicola King investigates the fascinating world of upcycled bots... 


hile countless Raspberry 

Pi robots have been 

created, most of them 
are on the small side. Hoverbot, 
however, bucks this trend and 
comprises upcycled parts including a 
hoverboard and an IKEA table. 

Maker Isabelle Simova explains 

that she did not set out to build a 
robot of a particular size, but first 
asked herself a number of questions 
about what makes a useful robot. 
“T considered a couple of relevant 
scenarios like moving goods around 
a store, picking up items at home, 
or watering plants. For a robot to 
accomplish those tasks, at the very 
least it needs to run for a reasonable 
amount of time (at least a few hours) 


22 | MagPi September 2018 


and be strong enough to carry a good 
amount of weight (10 kg or more).” 

So, Hoverbot was born, a large 
robot that is equipped with sonar 
sensors for obstacle detection and 
is powerful and sturdy enough to 
transport heavy items. “Hoverbot is 
strong enough to carry me around,” 
says Isabelle, “though I wouldn’t 
recommend it to other people for 
safety reasons!” 


Recycle, repurpose, 
regenerate 

Taking around three months to 
build, Hoverbot is essentially 

an upcycled machine, a concept 
that was important to Isabelle. 
“When you repurpose consumer 


goods you are not only leveraging 
the economies of scale that 

make otherwise expensive items 
affordable, you are also leveraging 
and extending work that has already 
been done by someone else,” she 


jotor Status 


> euenne 
Fi 


Above A web dashboard enables remote 
control of Hoverbot, including text to 
speech to make it talk 
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says, adding that “upcycling can 

be a great forcing function for 
productivity as well. It can give you 
a concrete starting point in what is 
sometimes an intimidatingly large 
search space .... When you upcycle 
something you already have, you are 
putting something to use that might 
otherwise end up ina landfill.” 
Clearly a point that our consumer- 
driven societies need to take on 
board, and something that a lot of 
makers and hackers generally are 
already aware of. 


Trial and error 
A disassembled hoverboard met 
the requirements of the project, 
and at a fairly low cost. Isabelle 
met various challenges along the 
way, including reprogramming the 
motor controller, which required 
her to write firmware without any 
manufacturer documentation. 
“The process involved some 
trial and error and | accidentally 
let the magic smoke out of two 
hoverboard motor controllers.” 
Having used the Raspberry Pi in 
other projects, she was confident 
that it was up to the job: “With 
a Raspberry Pi you can... both 


INNER WORKI 
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HOVERBOT 


Projects 


The Hoverbot in autonomous mode, using 
its sonar sensors to avoid obstacles 


easily interface with devices over 
GPIO and run software written in 
high-level programming languages 
like JavaScript and Python. With 
Node. js on the Raspberry Pi, I 

was able to write all the Hoverbot 
application logic in JavaScript and 


and extending the robot’s 
capabilities, as she explains: “Its 
current incarnation doesn’t do 
much beyond driving around and 
avoiding obstacles, so it does 
need a bit more intelligence to 
accomplish useful tasks.” 


Hoverbot is strong enough to carry me 
around, though I wouldn't recommend 
it to other people for safety reasons 


leverage existing Node.js modules 
for serial and SPI communication.” 

Isabelle tells us she will continue 
to tweak the Hoverbot, improving 
the motor controller firmware, 


It’s truly inspiring to see 
what can be built with a dose of 
ingenuity and just a few items, 
some of which may otherwise have 
been destined for the bin! 


NGS OF HOVERBOT 


>STEP-02 
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DESIGN, CREATE, AND DISTRIBUTE YOUR OWN GAMES WITH OUR 
GUIDE TO EASY DEVELOPMENT TOOLS FOR THE RASPBERRY Pl 


K.G. is a developer, software 
preservationist and avid player 
of obscure indie games. They're 
currently developing audio 
systems for Deck of Bards’ 


Codename Caerus. 
* rs * twitter.com/kgorphanides 


oxy 


ete 
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t’s easier than ever 

to make and publish 

your own games, and 
the Raspberry Pi is a perfect 
development platform, thanks toa 
wide range of tools and a hardware 
spec that encourages efficient, 
widely compatible design. 

If you’re new to programming, 
there are plenty of development 
environments that are easy to 
learn as you go, thanks to clear 
interfaces and copious tutorials. 
Whether you want to make an 
adventure game, a shoot-’em-up 
or a platformer, we’ll help you 
find the tools you need. 

Some of the most innovative 
games and interactive experiences 
combine or defy established 
genres to create something 
entirely new. 
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THINK SMALL 


A successful game project is the 
one you finish. If you’re a solo 
developer working on your first 
or second game, it’s probably a 
mistake to set out to make a vast 
open-world RPG. 

There’s a huge audience for 
tiny games, and the process of 
developing a small but perfectly 
formed gem can teach you a lot 
about tight design, efficiency, and 
good development practices. 

Best of all, when you’ve finished 
your game, you can share it with 
the world before going to work on 
your next fantastic project. 


PLAN YOUR DESIGN 


The first stages of game 
development don’t require any 
tech at all: your brain and some 


= 


way of taking notes are basically all 
you’re going to need. 

What do you want your game to 
do? Do you want to tell a specific 
story, create a world for the player 
to explore, or present a puzzle or 
physical challenge to be overcome? 
Which development tools and 
game styles are most appropriate 
for your project? 

What skills do you have and 
what resources are available? 

Are there any particular areas of 
design and development that you 
want to try out? 

If you’re particularly comfortable 
with your ability as a 2D artist, 
then a visual novel could be 
perfect. Writers and storytellers 
can try their hand at text-based or 
simply illustrated narrative games, 
while keen programmers could 


Left: Learning 
how to work with 
simple game 
development 
tools can help 
you learn the 
fundamentals of 
programming, 
with a concrete 
goal at the end 
of it all 
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An icy crust has settled over the snow that leads to a narrow path through the 


evergreen forest, but it's clear that people have walked this way recently. 


The snow underfoot thins as you pass beneath the trees, and a thick floor of fallen 


leaves and soft pine needles protrudes in patches where the snow and ice thins. 


The trail is little wider than an animal track. 


You can or keep wal 


Current mode: wholesome 


Switch inwholesome 


~ focus on logic or action games 

| illustrated with Creative Commons 

= image assets. 

a For most games, you’ll need a 
plot or objective (even if it’s as 

» simple as ‘rescue the kidnapped 

2 king’, ‘collect the blue spheres to 

* replenish the planet’s soul’, or 

_ = ‘defend the bug-eyed monsters 

. from a human invasion’), probably 


f_. everything together and turn your 
idea into a functional game. 

If you want to experiment with 
= programming and development 
= but don’t know where to start, 
then a ‘fantasy console’ such as 
PICO-8 gives you a development 
environment with a complete but 
helpfully restricted set of features, 
so you can focus on making your 
game without being overwhelmed. 


PUBLISHING 
YOUR GAMES 


Once you’ve finished your game, 
it’s easy to publish it, whether 

for free, as pay-what-you-want 
donorware, or for a fixed price. 
Two of the best platforms for 
independent games publishing are 
Itch.io and GameJolt.com. Both of 
these popular digital stores let you 


ay fF If you need a bit of 

ae inspiration or motivation, 

Hi try a game jam he | 
c some graphics and sound effects, publish games free of charge and, 
» = and some programming to hold if users pay for your game, take 


a small percentage of that fee to 
cover their costs. 


GAME JAMS 


If you need a bit of inspiration 
or motivation, try a game jam. 
These events invite participants 
to produce a game on a specified 
theme, sometimes using a 
particular game engine, within 
a set period of time. 


Every year, there are hundreds of game jams: free community challenges where 
people come together to make games within a set theme and time limit. 
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Far left: You 
can use game 
creation tools 
to write deeply 
personal stories 
for a specific 
audience... 


Left: ..Or a fun, 
throwaway 
tribute to the 
classics, just to 
learn how they 
were made 


Game jams take place both on- a 
and offline. Some are competitive, , 
with plaudits or even prizes for J 
the highest rated titles, but most a 
are just an opportunity to test your 
skills, make something cool, and : 
talk to other people who share your 1 
development interests. " 

Offline game jams in particular oy 
encourage people to work together, "1 
giving artists, musicians, writers, . 
and programmers a chance to 
combine their talents to create 5 
something more sophisticated g 
than they could alone. Many online 
jams encourage the same kind of 
teamwork, using communication 
platforms such as Discord to get 


people talking. 
Fans of different game engines 
or genres hold regular dedicated E ae see te 
jams or contests. Notableannual , e , 7 = 
events include IFComp for text IC 2 
games, make-a-game-in-a- A 
weekend jam Ludum Dare, and . = 
the Global Game Jam at physical "n 
locations around the world. You 1: 
can also find lists of game jamson ‘= 
Itch and Game Jolt. 4 


INDIE GAME JAMS LIST 
indiegamejams.com 


ITCH.IO JAMS 
itch.io/jams 


GLOBAL GAME JAM 
globalgamejam.org 


GAME JOLT JAMS 
jams.gamejolt.com 


LUDUM DARE 
ldjam.com 


IFCOMP 
ifcomp.org 


a ne 


YOU WILLNEED 


PICO-8 ($14.99) 


magpi.cc/NIBFUe 


ICO-8 is a fantasy 

console - a tiny virtual 

machine that pretends 
to be an 8-bit games console 
or home computer. It uses an 
implementation of the Lua 
programming language with 
special libraries and features to 
make it easier to make games. 

PICO-8 isn’t open source and 
you’ll have to pay for it, but 
$14.99 gets you perpetual, DRM- 
free updates and you can sell or 
give away the games you make 
without restriction. 

Some of the most important 
decisions in game design are 
about what your game won’t 
do. Narrowing your choices and 
options through mechanical 
means is an excellent way of doing 
this. PICO-8’s fantasy console 
conceit means that you only have 
to deal with a 16-colour display, 
six control inputs, four audio 
channels, and a maximum 32kB 
compiled game size. 

Once you’ve created a game, 
you can save and distribute it as 
a virtual cartridge that can be 
packaged as a standalone game 
or played via a web browser. You 
can also import other people’s 
cartridges to take a look at 
their code. 
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0} PICO-8 

Lexaloffle fulfils PICO-8 orders 
via the Humble store. After 
buying it, youll be emailed a 

link to download the software 

and associate it with your 
lexaloffle.com account. It’s worth 
registering on the site to get 
support, distribute your games, 
and engage with the community. 


from Humble or Lexaloffle. 
Expand the zip file wherever you 
like, go to that directory, and run 
the app from the File Manager 

or the command line. It’ ll 
automatically create some hidden 
directories to store its game files 
the first time you run it. 


For the Pi, you should download 
the Raspberry Pi version of PICO-8 


STEP USING PICO-8 


The fantasy console 

opens at the main 
PICO-8 screen. Like the main 
interface of early home computers 
such as the C64 and Spectrum, this 
is where you can load programs 
and run simple command strings 
in Lua. 

PICO-8 comes with a demo 

pack, which we’ll install and take 
a look at... 


INSTALL_DEMOS 
CD DEMOS 
LS 


To play any of the listed games 
and demos, use the LOAD and RUN 
commands. For instance, to play 
The Adventures of Jelpi: 


LOAD JELPI 
RUN 


...and then press ESC when 
you’re ready to quit. 

Many other game cartridges are 
available to download online, both 
as paid and free games, but make 
sure you put them in Pico-8’s 
working directory. On the Pi, 
that’s: ~/.lexaloffle/pico-8/carts. 
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To get from the main 

screen to PICO-8’s game creation 

a tools, all you have to do is press 
i" ESC. If you’ve loaded a game into 


& 
~~ LET’S HAVE SOME AUSIC 
co) 


CTOR = {} --ALL ACTORS In UORLE 


Lit 
SPARKLE = {} 
-- WARE Ah ACTOR 


‘ @iUy Ebiron 

a" ot At the top right, 

= a bank of icons lets you shift 

. between edits. To the right 

» of the text editor - with an icon 
F that’s either a pointy-toothed 


i" mammal or a butterfly — is the 
sprite editor. 

Tt. Each sprite is 8x8 pixels in size 

” and can take full advantage of the 

“ console’s 16-colour palette. You 


can create up to 128 sprites, witha 

» further 128 that can optionally be 
stored in memory otherwise used 

© for the game’s world map. Sprites 

» are shown in numbered banks 

= towards the bottom of the screen, 

a) which you can switch between using 

7 the mouse. 


memory, you’ll be able to browse its 
code. Otherwise, you’ll be presented 
with a blank input screen. 

Although it looks basic, PICO-8’s 
editor has far more features than 
the 8-bit computers that inspired it. 
Most important of these are syntax 
highlighting and cut, paste, and 
selection features using the mouse 
or keyboard, as you would in any 
modern GUI editor. You can also 
search your code by hitting CTRL+F. 

At the top right, a number shows 
which tab of the text editor you’re 
on, while a plus sign next to it allows 
you to create new tabs within the 
same project, for example to keep 
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If you want to create an animation 
cycle for an ‘actor’ (a character or 
moving object in the game), just 
place all the sprites in that sequence 
one after the other and PICO-8’s 
code routines will easily be able to 


show them all in order — all you have 


to do is specify the initial sprite’s 
numbered position in the buffer 
and the number of frames in its 
animation cycle. 

Editing tools allow you to draw, 
select, copy, paste, move (pan), 
and flood-fill parts of your sprite. 
You can flip, vertically flip, and 
rotate sprites using the F, V, andR 
keys respectively. 

There are eight sprite flags in 
the form of coloured circles just 
above the sprite number marker. 
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different code elements manageably : 
grouped together. When you run your ri 
program, it’ll treat alltabsasasingle _™ 
program, running the code in them 2 
in order. Ee 
Icons at the top right let you a 
switch from the editor to PICO-8’s fs 
other integrated game-building a 
tools. The text editor is signified "a 
by a pair of brackets. a. 
While PICO-8’s built-in editor is af 
surprisingly sophisticated, you may a 
find a standard text editor more A 
capable and easier on the eyes. 4 


Fortunately, you can open and edit © 
-p8 files in anything from Leafpad = 
to Vim. fa 


ry —— 
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Each of these can be set to on or ™ 
off, and can be assigned to different 7" 
characteristics using the code editor, 5 
such as whether a given sprite will 1 
be solid or not. 

Above these are brush size and af 
zoom adjustment bars, which are 7 
handy if you’re working on sets of a 
sprites that will make up tiles of a Le 
larger piece. . 


* STEP MAP EDITOR Depending on your game’s style me 
2" OS The map editor works and scope, you may need to pan * 
= = ~ similarly to the sprite around the level quite a bit - the = 
“a editor, but with a much larger area. SPACE key activates the click-and- Ce 
rr. PICO-8’s default level map area drag to pan tool, and you can zoom re 
measures 12832, although you can in and out using your mouse’s scroll =, 
“, expand that to 1286, if you use the wheel or the < and > keys. ay 
©. shared space that could otherwise The location of sprites in the level _ 
“house extra sprites. is defined using x and y co-ordinates - 
Rather than drawing individual displayed in the bottom toolbar. You’ll al 
!. pixels, here you’lluse the draw toolto _at the top right allow you to switch be able to place interactive characters __ 
a place sprites as scenery, background between having the level occupy the and objects in the level by specifying s, 
=, E objects, and decorations inthe spaces __ full screen or partly obscuring it by the co-ordinates at which they should x 5 Me 
| r the player will be exploring. Buttons showing the sprite library. appear in your code. i i 
i z = 
BP MiP sete aT EE, pberypior/riton, 
i 1 1 E I 


STEP SFX EDITOR 
‘=, The built-in SFX (sound 
effects) editor makes 
it easy to create a rich soundtrack 
of 8-bit music and effects for your 


409% SPD lb LooF 00 (O00 
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game. Any SFX track you make 
can be called in your game’s code 
when an event occurs, or pulled 
into the music editor to create 
backing themes. 

For sound effects, you’ll mostly 
want an array of blips, beeps, and 
crashes. These are easily created 
using pitch editor mode. This lets 
you draw the shape of your music or 
sound, using a range of instrument 
voices inspired by classic consoles. 

Press TAB or select the 
appropriate icon at the top left 
of the screen to switch to tracker 
mode, which gives you individual 


control over each note, making 

it better for more complex music 
composition and editing the effects 
you created in pitch mode. 

In tracker mode, you can also use 
your computer keyboard to play in 
notes one at a time. Remember that 
inserting the same note repeatedly 
will result in a single long note at 
that pitch — to create a silent rest, 
just reduce the volume of a given 
note to 0. 

Each SFX track can have a 
maximum of 32 notes, and 
there’s room to store up to 64 
individual SFX. 
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STEP MUSIC 


07 EDITOR 


The music editor 


ole a allows you to assemble your SFX 
a | . 
Fy tracks to play simultaneously, 
1: consecutively, or in a specified loop 
- to build up your soundtrack. You 


"| can have up to four SFX playing 
simultaneously. By default, each 


, STEP LERRNING 
= = O& PICO-8’s minimal 
Lua-based API makes for a clear 
i and consistent programming 
. experience. The official manual’s 
plain text formatting is a little 
unwelcoming, but it provides plenty 
- of examples of how to use its more 
F complex features. 
However, to get to grips with the 
4 basics of your new fantasy console, 
the best thing to do is look through 


RESO 


PICO-8 MANUAL 


magpi.cc/uXMVws 


SCUMM-8 
magpi.cc/LaGTWu 
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SECTORDUB’S PICO-8 FANZINE 
sectordub.itch.io 


PLATFORM GAME DEMO IN 100 LINES 
magpi.cc/nWFCrT 


pattern will move on to the next 
unless it hits a loop end marker 
- a loop begin marker allows you 
to determine where the loop will 
return to. 

You can have up to 64 of these 
patterns, and use the music() 
function to start and stop them 
in your game’s code. 
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OPEN PICK 
CLOSE LOOK-AT PULL 


“UP PUSH 


CIVE TALK-TO USE 


the code of the supplied demo 
games, copy it, and then modify it 
to create your own first games. 
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If you want to make a specific na — 
kind of game for the PICO-8, such = — 
as a shooter, platform game, or even ~ 2 = 
a point-and-click adventure, there , — 
are dedicated game engines and A — 
demos for the system that provide * — 
all the code you’ll need to make By = 
different types of game, which you ts —= 
can then work with and customise 40 L. == 
for your own purposes. Paul = == 
‘Liquidream’ Nicholas’s SCUMM-8 "es = 
graphic adventure game engine is : —— 
particularly impressive. fa — 
= 


| RmCES FOR PICO-8 ° DOWNLOAD PICO-8 GAMES 


itch.io/games/tag-pico-8 


gamejolt.com/tag/pico8 
magpi.cc/qkBOds 
FEATURES OF PICO-8 LUA 
pico-8.wikia.com/wiki/Lua 
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ELEING 
ho aS. 


VOUT TERED, 
TVINESS 


arrative games range 

from simple interactive 

storybooks to puzzle-filled 
adventure games and combat- 
packed RPGs. We’re going to look 
at two of our favourite tools for 
making story-based gaming worlds 
in very different styles. 


stories and choose-your-own- 
adventure style games, but has 
a scripting language powerful 
enough to support fully fledged 
RPGs and strategy games. Both 
Twine and the games it makes run 
in a browser. 

Your game is built up of 
passages of text, which are 


TWINE HARLOWE MANUAL 
twine2.neocities.org 


BITSY-NWJS 
magpi.cc/ WHCsGD 


WERUING A 
NARRATIVE 
WITH THINE 


Twine is a favourite development 
tool among game writers keen to 
show off their narrative chops. 

It lends itself to interactive 


TM eitsy x 


S @ localhost: 


Hello, small cat 


shown on an overview screen as 
little interlinked cards. Because 
it supports branching dialogue 
and plot paths, Twine is a great 
tool for mapping out the path 
of narrative games destined for 
other platforms. 


Bitsy - Chromium 


iory] # download [ag 


The first thing to do 

when starting a Bitsy 
project is name your 
game in the title field 


Each room in your game has a 1616 grid that 
you can populate with characters and scenery. 
We've made ours black and white, but you can 


use any three colours in your game 
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BITSY TUTORIAL “Hh 
magpi.cc/QxmzMO 


Its most basic function is the 
[[1ink]] command. If you put any 
string of text between two sets of 


Hello, small cat 


You draw all characters, 
objects, and scenery as small 
8x8 images. The sprite class, 
for interactive characters 
and items, can have dialogue 
boxes to communicate with 
the player 
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There's no standalone Twine desktop client for the Raspberry Pi, but 
a local version of the engine called TwineJS is maintained by original 
creator Chris Klimas. 

Open a Terminal window and type the following commands: 


curl -sL deb.nodesource.com/setup_8.x | sudo -E bash - 
sudo apt install -y nodejs 

git clone github.com/klembot/twinejs.git 

cd twinejs 

npm install (to install Twine’s dependencies) 

npm start (to start Twine ona local server) 


My name is 
' I am a snake 


Access Twine from Chromium by going to http://Localhost:8000. 
Runnpm start from your twinejs directory every time you want to 
work on your game. 


Bitsy games are published as HTML : A . . ; 
files, which you can upload to a user community, with regular You get an 8x8 pixel grid with 


website or email to your friends game jams to inspire to you tryout two frames of animation to draw A 


F your skills. four key object types: a! 
. = square brackets [[like this] ], Bitsy is self-consciously simple, P 
+ Twine will automatically create which makes it ideal for anyone 


a new passage with that name who’d rather tell stories and Your game’s 
- and display a link to it from your build worlds than immediately playable character 


current passage. dive into coding. It’s particularly a: 
. good for linear and exploration- Scenery that can be a ss 
7 TINY GARE DESIGN based stories or object collection either solid walls or 1 

- # ie BITSY games. You can implement simple decorative items that [iM a ae 

’ Bitsy is an easy-to-use tool for puzzles using its conditional can be walked over 

creating three-colour pixel art dialogue options and even expand 
J adventures in your browser, either _—_ Bitsy’s core functions using your Interactive scenery and 
ol on- or offline. First released in own or other people’s extensions non-player characters 
- i early 2017, it already has a huge and hacks. 
rt Objects that can be 
AUN DITSOONTHE PIE «. al 
JI Stisoy COT Tre LA 
ot 
While Bitsy normally runs in a browser directly from the creator's You can use these objects to 


website, there's an offline version that’s perfect for Pi development 
projects. It still works via a browser, but is fully functional without an 
internet connection. Install and build it with these commands: 


design and populate rooms ona 
Ideal for 16x16 grid, with small snippets of 
decision-based dialogue associated with sprites and 


narrative items. A tools button next to your 
games, Twine's 


curl -sL deb.nodesource.com/setup_8.x | sudo -E bash - Sane game’s title at the top of the screen 
sudo apt install -y nodejs screen can reveals more options including the 
git clone github. com/ztiromoritz/bitsy-nwjs.git show you how exits window, where you can join 


each passage 
of sa eense your rooms together to create a 


to all the others world for the player to explore. 


cd bitsy-nwjs 
npm install 
npm run build 


The build can take quite a while, even on a Pi 3 B+, making this an ideal 
time to go and get a cup of tea. With that done, launch your offline Bitsy 
server from its directory whenever you want to use it, by typing: 


npm run serve 


You can access it in your browser by going to http://localhost:8000 


ae ol 
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EIGHT MORE FASCINATING GAME-MAKING TOOLS FOR THE PI 


LOVE 


love2d.org 


wide range of game 

engines, integrated 

development 
environments, and markup 
languages designed for game 
development work brilliantly on 
the Pi. We’ve highlighted eight of 
the most interesting, with pointers 
on getting them up and running. 


“* 


If you've got to grips with PICO-8 and want something 
alittle more flexible, you might be looking for LOVE. 


This more advanced Lua-based game engine has 


been used to make some quite sophisticated titles 
and is regarded as being particularly good for mobile 
development. LOVE 2D is available in Raspbian's 
repositories (sudo apt install love). You'llneed 
experimental OpenGL drivers enabled in raspi-config 


and a text editor, ideally with a Lua code highlighting 


module, to write your game in. 


=120 


— 11,476 


Oh My Giraffe by Nico Prins 
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INFORM 1 
inform7.com 


An engine for creating parser text 
adventures (get lamp, light lamp, 


Hadean Lands by Zarfhome Software 


eat lamp) that lets you program 


games by writing sentences in 
natural English such as ‘The Cave 
is aroom. A dragon is here.’ 

It’s easy to get started by writing 
out a few sentences to describe a 
room and the items it contains, but 
the well-documented programming 
language has tremendous power 
that you can use to create anything 
from complex conversations to 
environmental physics. Only the 
command-line compilation tool 
is available for 32-bit systems 
like the Pi, but you can follow the 
documentation to write your game 
in a standard text editor. 
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RENFY 


renpy.org 
Ren’Py is a Python-based game 
engine for making visual novels 

— a popular form of illustrated 
adventure game that originated in 
Japan. These can focus on dialogue 
or include puzzles, 
and typically have 
rich still graphics 
and at least mildly 
choice-based 
plots. Ren’Py 

has been used to 
make commercial 
hits like Long 

Live the Queen 
and can produce 
very polished 


results. Bear in mind, though, 
that Raspberry Pi support is 
still experimental and requires 
Fake KMS OpenGL drivers and 
extra graphics memory to be set 
in raspi-config. 


Long Live the Queen by Hanako Games 
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TIC-80 


tic.computer = 
If you like the look of the fantasy 
computer trend but would prefer 
to go for a free and open-source 
option, the TIC-80 tiny computer 
may tickle your fancy. It’s virtually 
equipped with a 240x136 display, 
16-colour palette, 256 8x8 sprites, 
and four-channel sound, and has 
a full set of integrated tools to edit 


FPS80 by Bruno Oliveira 


+ 


CHOICESCRIPT 


magpi.cc/XSfqoo 
ChoiceScript is the markup language 
behind the very popular Choice Of 
series of interactive fiction games 
for mobile and web platforms. 
They’re simple choose-your-own- 
adventure style games, ranging 
from horror to romance, with 
an emphasis on quality writing. 
Choice Of Games even has a paid 
publication path with a 25% royalty 
rate for new writers and advances 
available to experienced authors. 
All you need is a text editor and 
the supplied files to make your 
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PYGAME AND PISD 


pygame.org - magpi.cc/ZEIPjL 
Pygame and Pi3D are two sets of 
games programming libraries for 
Python that are ideal for Pi users 
who are learning the fundamentals 
of game development. Pygame 
comes installed on Raspbian by 
default and is packed with useful 
functions for everything from 
physics to animation, with loads 
of examples and documentation 
available online. 

You’ll have to install Pi3D 
separately, but it’s a great Python 
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com DAY] ruesoar ° 
on 


code, create graphics, build levels, 
and write music. 

It also supports a wider range 
of programming languages 
than PICO-8, with JavaScript 
and Moonscript as well as Lua. 
Compiling from source works 
best on the RetroPie operating 
system and there's also a pre-built 
JavaScript version available to 


80 Days by Inkle Ltd 


download and run in your browser. : 

_) = § magpi.cc/pBmaCl F 

: = » Achoice-based markup language, famously " 
: »" used to develop the award-winning 80 Days and *. .1 
3 f Sorcery games, Ink can be used as middleware La J 
, © alongside other game engines or to create a 
~~” standalone narrative games. The open-source © 4 
: = Inky editor allows you to test games as you go, ". 
- "and export them to a web-playable version for Ca | 
” ss release. You’ll need to install mono-complete : 5 
» = from Mono’s own repositories to build Inky - = 
me” = full dependencies are listed in its readme file. 5 i 


own ChoiceScript games. The r 
instructions on the download page 
are a little out of date — you’ll now 
find the extracted test game script at ._j 
[web/mygame/scenes/startup.txt. _|j 


SCRATCH 


scratch.mit.edu 
Scratch comes with every Raspbian install. It's well 
documented and is explicitly designed to be easy 
for beginner programmers, with a drag-and-drop 
interface that allows you to build up sequences 

of action and logic, including graphical and 

audio elements. 

The visual programming interface uses 
instruction blocks that bolt together and can be 
used to define text, control systems, variables, and 
more. A huge range of games, slideshows, and 
stories are available on the official Scratch website, 
and you can look at their code to learn by example. 


The Road to Canterbury 
by Choice of Games 4 


toolkit for getting the Pi to do 5 
something no one really expects 

of it: 3D graphics rendering. 

Don’t forget to allocate extra 
memory to the GPU before running 
Pi3D’s demos. 


Ca Wi 


Pi3D forest walk demo 
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PI ZERO W 
STARTER KIT 


Pi Zero W 


Pi Zero W case 
with three covers 


USB and HDMI 
converter cables 
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Camera Module 
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Use screenshots to show others how you set up the software for your projects 


Cance 


Application 


Take Screenshot 


Calculator png (357x371) 100% 


Tutorial are 


16 x 3-LED 
push lights 
magpi.cc/ 
iEKiUY 


Red, green, 


Flare | 


blue transparent 
paint 
magpi.cc/ 
vBcYrB 


16 x 510Q 
125mW resi: 
magpi.cc/ 
mDWDHU 


istors 


1280«18x6mm 


Strip pine 
magpi.cc/ 
iXECkc 


Gorilla Glue 
magpi.cc/ 
eluwAl 


320x320mm 
MDF 6mm thick 


MIKE COOK 


Veteran magazine author from the old 
_ days and writer of the Body Build series. 
Co-author of Raspberry Pi for Dummies, 


Raspberry Pi Projects, and Raspberry Pi 
Projects for Dummies. 
magpi.cc/259aT3X 


PART O01 


THE MATRIX 


The Matrix is an undedicated array of switches and lights 
that can be put to any number of uses - animated light 
displays, games, and controlling synthesizers, to name 
but three. Best of all, it won’t cost you a fortune 


na thrift shop, we spied white LED stick-on 


set us off thinking what we could make with 
them. We came up with an illuminated switch matrix 
that could be used for many things. At the end of the 
project (in two or three issues’ time), after showing 
you how to interact with it, we thought we could set 
you a challenge to see if you could write your own 
software for a specific application. This is a project 
that will keep on growing. 
We are going to use a MAX7219 chip to drive the 


magpi.cc/ LEDs; this removes any real time burden off the 
SPEOIA Pi. Then, by acrafty modification, we are going to 
ot | 80.00 mm 
320.00 mm 
2 3 2 1 0 = 
|e + + + 8 
15.00 mm ee) 
F] j 
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Figure 1 Marking the underside of the board 
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battery powered lights at only £1 for two. That 


use the same chip to also read the state of the push 
switches. As these are latching switches, we will then 
use software to find out which switches have changed 
since we last looked at them. As three white LEDs are 
not too interesting, we will use transparent paint, 
normally used for painting on glass, to make our three 
LEDs show different colours. 


>STEP-01 

Mark out the box lid 

We didn’t do this step ourselves first, but on 
reflection we thought it would be easier to do before 
the sides were put on the box. Cut a 320x320 mm 
piece of 6mm MDF and mark out the squares for 
each illuminated switch, then number them. This is 
going to be the back of the box, hence the squares are 
numbered back to front. Each light will be in its own 
80mm space and you could change this if you want 
a bigger or smaller board. Then mark the position 
for the light’s fixing holes 15mm from the left-hand 
side and 46.5mm from the top. The dimensions are 
shown in Figure 1. 


>STEP-02 

Mark out the front 

Flip the board over and draw a light pencil line 
horizontal line across the whole board 46.5mm 
down from the top. Repeat this 46.5 mm up from the 
bottom. Finally, draw two more lines 80mm down 
from the top line and 80mm up from the bottom 
line. This will serve as marker for when you later fix 
the lights. Now flip the board over and drill the 3mm 
holes marked in Figure 1. Like all holes, drill onto 

a scrap piece of MDF to ensure a clean edge to the 
hole, and clean up any bits of MDF round the hole 
with a scalpel. 
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Glue & Clamp 


Fitting the sides to the box 
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Figure 3 Drilling indents for glue to expand into 


Preparing the box sides 

Cut four pieces of 320x168x6 mm strip pine. Make 
sure the strip pine is the same size as the MDF. Mitre 
the ends of two pieces of strip pine at 45°, as shown 
in Figure 2. This can be done with a hacksaw and 

file — or better, if you have one, a disc sander with 


The push light’s components, from left to right: 
cover, lens, reflector, PCB, battery tray, and base 


Figure 5 Removing the 
battery tray from the cover 


the guide set to 45°. Draw a line, using the strip pine 
as a rule down each side. Use a3mm drill and puta 
sequence of very shallow indents at approximately 
30mm spacing along the length of the strip pine, as 
shown in Figure 3. Then do the same for the MDF. 
This is to allow the glue to expand into the indents 
and have more grip. 


Fitting the box top and bottom 

Gorilla glue is a foaming expanding glue that works 
by the absorption of moisture. When you are ready, 
spray a small amount of water from a plant mister 
spray onto (or wipe with a damp rag) the surfaces 
you are going to join together. These will be the top 
and bottom sides. Apply a thin layer of glue to each 
side and clamp the two sides together. The strength 
of the glue joint depends on the two sides being 
clamped together. Allow the glue to set for at least 
two hours — see Figure 4. When set, trim off any 
glue that has seeped out of the joint on the outside 
with a scalpel. 


Fixing the box sides 

Referring back to Figure 2, take the other two lengths 
of strip pine and mitre them. This time, make sure 
there is a good fit between the two strips already 
attached. This might involve taking off a little more 


Figure 7 The unmodified PCB assembly 


until the side strips fit snugly. Now take the left- 
hand strip and file a shallow indent 51mm wide and 
2mm deep in the centre of the strip. This will allow 
a ribbon cable to the Raspberry Pi to slip out of the 
box when a base is fitted. This is represented by the 
hatched area in Figure 2. Again, drill shallow indents 
in the strips, spray with water, then glue and clamp 
to form the tray. 


Assessing the lights 

Take one of the LED push lights and take it apart; if 
you have any trouble detaching the battery tray from 
the base, see ‘Detaching the battery tray’ box. Then 
lay out all the parts as in Figure 6. To make sure we 
refer to them consistently, they are, from left to right: 
cover, lens, reflector, PCB, battery tray, and base. At 


this stage, the PCB and the battery tray are joined with 


two wires; let’s keep it like this for the time being. 


Preparing the LEDs 

Figure 7 shows the PCB with the LEDs on it 
attached to the battery tray with two wires. 

This might be a good time to test the unit by 
inserting the three AAA batteries and making sure 
the central switch turns the LEDs on and off. In order 
to make the light displays a bit more interesting, 

we are going to paint each LED in the light’s cluster 
with a transparent paint — this is normally used 

for making easy stained glass projects. You can get 
paint like this from any craft store. We chose the 
colours red, green, and blue, although you could use 
any you like. 


Figure 8 Letting 
the paint dry with 
LEDs upside down 


Painting the first LEDs 

Paint the first LED — that is, the one between the 
wires attaching it to the battery tray — red. Make sure 
the paint is spread all over the LED and turn it upside 
down to dry. This is to ensure that any surplus paint 
collects over the tip of the LED, where the light is 
stronger. We used the base and odd bits of wood to 
make sure the wet paint did not touch the table - see 
Figure 8. If too much paint gathers, just touch the 
forming drop with a brush to drain the paint from it. 


DETACHING 
THE BATTERY 
TRAY FROM 
THE BASE 


Figure 9 The 
finished paint job 


Tutorial Wat aes 


The original 
schematic of the 


Latching switch push-on lights 


>STEP-09 unpainted clear bits. At this stage, if you think the 
Finish off the painting colours are washed out, you can always add a second 
Allow the paint to become touch-dry, which can coat of paint, although on the final project the LED 
take two hours, and then paint the LED to the left brightness will be adjustable. 

of the red one green and again allow to become 

touch-dry. Finally, paint the LED to the left of the >STEP-10 

red one blue and this time leave it for 24 hours to Assessing the circuit 

become hardened. Figure 9 shows the finished Figure 10 shows the schematic of the LED’s PCB 
painted LEDs on the PCB board. Again, check with (printed circuit board). Trace through the circuit and 
batteries that the LEDs work and that there are no make sure that your lights are wired the same. The 100 


Cathode schematic we need 


for this project 
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Figure 13 The final modified PCB 


SW 


Figure 12 How to 
modify the light’s PCB 


resistor and the batteries’ internal impedance act as a 
crude limit to the current through the LEDs. The LEDs 
themselves are wired in parallel, which is not good 
practice, and the latching switch connects the positive 
anode of the LEDs to the positive of the battery supply. 
Other makes of light might be wired differently; be 
cautious if your PCB is not like the one shown here. 


The circuit we want 

We want to control the LEDs separately with a 
MAX7219 driver chip, which requires common cathode 
LEDs, so we must modify the PCB in order that the 
circuit is compatible with the MAX7219. Figure 11 
shows the schematic of what we want the PCB’s 

ircuit to be. Each LED’s anode needs to be capable of 
a separate connection to the MAX7219, the cathodes 
need to be common, and the switch should connect to 
these cathodes through a510Q resistor. This can bea 
replacement to the existing resistor, but if we make it 
a125mW one it will fit properly between the holes in 
the existing PCB. 


[o) 


Replace with 5100 


Green LED 


Blue LED 


Modifying the PCB 

Figure 12 shows a drawing of the PCB with the 
modifications we need to make. We need to change 
the resistor, make three cuts to the PCB tracks, and 
wire a link between two points. At this stage we need 
not wire anything to the three LEDs nor the cathode 
or SW pads; we will do that later. Start off by removing 
all the resistors and replacing them with 510 ones. 
Then you need to make three cuts in the PCB. This 
can be done with a scalpel, making two cuts very close 
together and peeling away the PCB between. But a 
better way is to use a Dremel cut-off wheel and just 
make the gentlest of touches to remove the copper 
strip. Finally, use a small piece of wire to link the 
switch to the cathode lines. 


That concludes this month's article. 


Next month we will see how to make 
the control board for the matrix. 


Tutorial 


Al 


A2 


FINISHED 
PCB 


PYGAME ZERO gNseigek 


Raspbian Jessie 
or newer 


An image 
manipulation 
program such as 
GIMP, or images 
from magpi.cc/ 
xdgVU 


The latest 
version (1.2) of 
Pygame Zero 


A lot of patience 
to play the game 


STEP BY STEP 


THE 


SCRAMBLED 
CAT GAME 


A challenging game with minimal code using Pygame Zero Actors. 
In this third tutorial of the series, we introduce several new game 


programming techniques 


hen your author first came across this type 

of game, it was in the form of a plastic frame 

with numbered tiles and was handed to him 
by his grandmother to keep him quiet for a while. It’s 
an infuriating game much like a 2D forerunner to the 
Rubik’s Cube, where the player must move jumbled 
up tiles around the frame to put them back into the 
correct order, except that there is only one spare space 
to move tiles into and you seem to end up with an ever 
more jumbled collection of tiles. In this version, the 
author’s cat, Widdy, has very kindly donated himself 
to be scrambled. 


>STEP-01 

Decisions, decisions 

When first approaching a sliding tile game, 

our first thought would be to have a matrix 

variable (or two-dimensional list) representing 

the frame with its tiles. You would then have a 
process function to handle the tiles moving around, 
changing the values in each of the matrix positions. 
However, Pygame Zero has a few tricks up its sleeve 
which work very well in this circumstance. Pygame 
Zero Actors are your friends and can save you a huge 
wedge of coding time. Let’s get stuck in and set 
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THE SCRAMBLED CAT GAME 


your program up with a few standard Pygame Zero 
basics, as in Figure 1. 


>STEP-02 

Getting the groundwork done 

Before we get into the visuals, you may notice that 
there are several functions in Figure 1 with just the 
keyword pass in them. In Python we are not allowed 
to have an empty function, so if we write pass in it, 

it means that the function should do nothing. This 
may sound a bit strange but it means that we can build 
the basic structure of our program before we start 
thinking about the finer details. Now that we have our 
structure, we can add some background graphics. If 
you have downloaded the graphics from our GitHub 
link (magpi.cc/xdgVJJ), we can add a background 
colour with screen.fill(red, green, blue) and 
then ‘blit’ a frame using screen.blit('board', 
(15@, 50)) in the draw() function. 


>STEP-03 

A night on the tiles 

You may have noticed the rather stylish wooden frame 
that is now displayed if you run the program. It was 
carved out of the author’s coffee table for this tutorial 
and will serve as the holder for the tiles we are about 
to create. All we need to do to create the tiles is to 
define a list to hold the tile Actors and then a function 
to create and arrange the new Actors in the frame. We 
can do this with a double loop to set the x and y co- 
ordinates of each tile. So first, define the tile list near 
the top of the code using tileList = [] andthen 

a function to make the tiles. Have a look at Figure 2 
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You can find suitable 
images for games 
around the house. For ~ 

_ this game we used a 

cat and a coffee table 


WRITING 
YOUR 
PROGRAM 
STRUCTURE 


When creating 
your own 
programs, 
you can start 
by writing 

a structure 

of empty 
functions 
before writing 
the detailed 
code. This 
can help to 
visualise 

the way the 
program 

will work. 


>PYTHON 
e1. pgzrun DOWNLOAD: 
@2. WIDTH 800 magpi.cc/xSnagK 
@3. HEIGHT 600 
04. gameStatus = @ 
65. 
@6. def draw(): # Pygame Zero draw function 
07. 
68. 


@9. def update(): # Pygame Zero update function 

10. 

abit 

12. def on_mouse_down( Nig 

13. 

14. Figure 1 The basic 


setup for our Pygame 


15. pgzrun.go() Zero program 


(overleaf) to see how we can do that. We can call our 
makeTiles() function at the end of the code, just 
before pgzrun.go(). 


>STEP-04 

Stating the obvious 

One technique that we have used in both previous 
tutorials in this series is to use a variable to keep track 
of the overall state of the game, and this game is no 
different. We need to know if the player is allowed to 
interact with the tiles or if they have completed the 
puzzle and a few other things too. For this we can 
define a global variable gameStatus = @near the top 
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COLLISION 
TESTING 


There are 
several 

ways to test 
collisions. For 
our border 
tests, we could 
have used 
border Actors 
and tested 
collision with 
them instead 
of using a 
mathematical 
check. 


of our program. In this game we will use the value 0 
to allow the player to interact with the tiles, then 1 to 
show that a tile is being moved, 2 will mean that we 
are preparing the game (more on this later), and 3 will 
show that the player has completed the puzzle. 


>STEP-05 

Point and click 

In this game we will be using two different types of 
user input to give the player a choice of how to control 
the tiles. Players will be able to click on a tile to get 

it to move into the spare space, but we will provide 
the option to use the arrow Keys too. These two 

input methods work quite differently, so let’s look at 


Figure2.py 


@1. def makeTiles(): 


@2. global tileList 

63. xoffset = 251 

4. yoffset = 151 

05. X=y=c=20 

66. while y < 4: 

07. while x < 4: 

8. rde 4 ale 

e9. tileList.append(Actor("img"+str(c), 

pos = (xoffset+(x*100), yoffset+(y*100)))) 

10. c t= 1 

ilabe xX += 1 

12. x e Figure 2 The makeTiles( ) function. 
We loop from 0-3 using y and inside 

13. yt=1 the Loop from 0-3 using x 


Figures py 


Figure 3 Using a locking 
system while player inputs 
are being processed 


. def on_mouse_down(pos): 


e2. if (gameStatus == @): 

63. doLock() 

e4. for t in range(15): 

65. if tileList[t].collidepoint (pos): 

06. m = moveTile(tileList[t]) 

07. if(m != False): 

68. animate(tileList[t],on_ 
finished=releaseLock, pos=(tileList[t].x+m[1], 
tileList[t].y+m[2])) 

9. return True 

10. releaseLock() 

kal 

12. def releaseLock(): 

13. global gameStatus 

14. gameStatus = @ 

TS 

16. def doLock(): 

iNT / 5, global gameStatus 

18. gameStatus = 1 
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mouse input first. Pygame Zero provides a function 
on_mouse_down(pos) so that we can capture a mouse 
click. We then compare the co-ordinates in the 
variable pos to the tiles to see if they collide. If they 
do, then the player has clicked on a tile. 


>STEP-06 

Which tile? 

To check which tile was clicked, we can use a for 
loop. We know how many tiles we have (15), so 

we can say for t in range(15):, where the 
variable t will be our counter. We can then check 
each tile to see if it has been clicked, with if 
tileList[t].collidepoint(pos):. While we are 
dealing with moving the tile, it’s a good idea to stop 
the player from interacting with the game, otherwise 
we may get several tiles trying to move at once. We 
can change the gameStatus variable to 1 to lock the 
input. See Figure 3 to see how this works in code. 


>STEP-07 

Let's get things moving 

You may notice in Figure 3, in the middle of the for 
loop there is acall to moveTile(tileList[t]). This 
is a function that will determine which way a tile 

can move. We are going to use the colliderect() 
method of our tile Actors to test all directions. If no 
collision is detected in a certain direction then we 
know that we can move the tile that way. We will also 
include a condition to test that the tiles cannot move 
outside the frame, so we will be using two types of 
collision detection: one with the built-in Pygame Zero 
Actor objects and one with a boundary check. 


>STEP-08 

Repel borders! 

Sorry for that terrible pun, but first we need to stop 
the tiles being allowed through the frame border. 

We can do this with a simple if condition for each 
direction. So for the right border we would say 
if(tile.x < borderRight): and then we would 
do our Actor collision test. We will need a border test 
for each direction. What we are actually doing in the 
moveTile() function is saying: “Can we move the tile 
right, or left, or up, or downe” If the answer to any of 
those is yes (and it can only be one of them or none), 
then tell us which way to move. 


>STEP-09 

Tiles to the left, tiles to the right 

There is a cunning plan you can use to test if a tile can 
move in a certain direction without seeing it move. If 
you add 1 to the x co-ordinate of the tile and then test 
for a collision — we are going to use a function called 
checkCollide(tile) — then we will know if a tile is 
to the right of our test tile. We then set the tile back 
to its original position by subtracting 1 from the x 
co-ordinate, and all this happens before the Pygame 
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Players can use the mouse or the 
keyboard to move tiles. Pygame Zero 


handles the animation frames with the 
animate() function 


Zero draw() function is called again so you never 
see anything move. We can also do the same test for 
moving right, up, and down. 


>STEP-10 

Collision course 

We need to write a function that will test to see ifa 
collision has happened when we moved our tile 1 unit 
(pixel). The checkCollide() function loops through 
the tile list and checks to see if any of the tiles are 
colliding with the tile that the player has clicked 

on. We just loop through the tile list and use the 
colliderect() method to test for collision (and also 
make sure we are not testing the tile that has been 
clicked) and if there is, return True. If no collision 
was detected then the function will exit with a False 
return value. Have a look at Figure 4 to see how we 
test a border and check for tile collision. 


>STEP-11 

Very animated 

We will need to add tests for left, up, and down to 

our moveTile() function; when that is done, it will 
return what is known as a tuple. This is a return value 
with several parts: the direction as a string, the x 
offset to move the tile, and the y offset to move the 
tile. This tuple gets sent back to our on_mouse_down() 
function and if it’s not False then we know we can 
move the tile based on the return values. We now 

call the animate() function. This is a Pygame Zero 
function to move an Actor from one place to another. 


>STEP-12 

Locking player interaction 

While we are animating the tile moving, we don’t 
want the player to be able to click on any other tiles. 
We have used our doLock() function to change the 
gameStatus to 1 so no mouse clicks are reacted to. 
When the animation has finished, we want the player 
to make their next move, so in our call to animate() 
we include on_finished=releaseLock. This will 

call the function releaseLock() which will set the 
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Figure't.py 


THE SCRAMBLED CAT GAME 


@1. def moveTile(tile): 


Tutorial 


Figure 4 An example of testing 
border collision and then using 
the Actor collision detection 


@2. borderRight = 551 

@3. rValue = False 

e4. if(tile.x < borderRight): # can we go right? 

@5. tile.x += 1 

06. if(not checkCollide(tile)): rValue = "right", 
100, @ 

@7. tile.x -= 1 

68. 

e9. return rValue 

10. 

11. def checkCollide(tile): 

ne for t in range(15): 

13. if tile.colliderect(tileList[t]) and tile != 


tileList[t]: return True 
14. return False 


gameStatus back to 0. This will mean that the player 
can click on another tile. You will notice from Figure 3 
that if the mouse click is not on a tile then the lock is 
released at the end of the function. 


>STEP-13 

Using the arrows 

The second way that we can capture the player’s input 
is to use the arrow keys. This form of input relies on 
the fact that if an arrow key is pressed (for example 
the up arrow), there is only one tile that is able to 
move in that direction — or alternatively, no tiles are 
able to move in that direction. So all we need to do is 
work out which tile can move in the direction of the 
arrow pressed. We are going to do this with a function 
called findMoveTile(moveDirection) and we pass it 
the direction of movement that we want it to look for. 


>STEP-14 

Scanning the keyboard 

First, we must check if the player is pressing one 

of the arrow keys. We do this in our update() 
function. We want to check if the gameStatus is 0 
before processing anything; if it is, we can check 

the left arrow key by writing if keyboard.left: 
findMoveTile("left"). We then write a similar 
line of code for each of the other arrow keys, passing 
a different string to our findMoveTile() function. 
In the latter function we use the same moveTile() 
function as we did with the mouse click input, but this 
time we check for the direction that has been passed 
by the keyboard press check. 


>STEP-15 

Which tile is it? 

Now all we need to do is write the FindMoveTile() 
function that scans through the tile Actors and 


MULTI- 
PURPOSE 
FUNCTIONS 


Try to write 
your functions 
so that they 
can be used 
in different 
ways, like our 
moveTile() 
function. 

If there is 
less code to 
write, there 

is less code 
to debug. 


WATCH 
OUT FOR 
MULTIPLE 
INPUT 


When using 
the Pygame 
Zero keyboard 
object to 

test for key 


presses, it 
doesn't return 
just a single 
event. It will 
continuously 
read as True 
while the 


player holds 
the key, which 
may not be 
what you are 
expecting. 
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Figureo.py 


1. 
@2. 
3. 
04. 
65. 
06. 
07. 
8. 
9. 
10. 
11. 
12. 
13. 
14. 


15. 
16. 
17. 


Figure6 ‘py 


2. 


3. 
04. 
65. 
06. 


07. 
8. 
9. 
10. 
11. 


12. 
13. 
14. 
15. 


48 


Figure 5 Moving tiles from 
the detection of a key 
press on the arrow keys 
def update(): # Pygame Zero update function 
if (gameStatus == @): 
if keyboard.left: findMoveTile("left") 
if keyboard.right: findMoveTile("right") 
if keyboard.up: findMoveTile(“up") 
if keyboard.down: findMoveTile("down") 


def findMoveTile(moveDirection): 
doLock() 
for t in range(15): 
m = moveTile(tileList[t]) 
if(m != False): 
if(m[@] == moveDirection): 
animate(tileList[t],on_ 
finished=releaseLock, pos=(tileList[t].x+m[1], 
tileList[t].y+m[2])) 
return True 
releaseLock() 
return False 


Figure 6 The scrambleCat() 
function. Pass a list of simulated 
keystrokes to findMoveTile(), just 
scrambleCountdown = 30 like if we were pressing the keys 
Seicelnlwyalistisie = |, Gh As 5 sly als ale als Sin Ga Gy 2s 
1, 2, 1, 3, 3, @, 3, @, 2, 0, 2, 2, 1, 3, 1, 3, 3; 


itr 


def scrambleCat(): 
global gameStatus, scrambleCountdown, 
scrambleList 
tileDirs = ["left", "right", 
if(scrambleCountdown > @): 
mt = False 
while(mt == False): 
= findMoveTile(tileDirs[scrambleList[ 
scrambleCountdown ] ]) 
scrambleCountdown -= 1 
gameStatus = 2 
else: 
gameStatus = @ 


up", "down" ] 


finds the one that can move in the direction that the 
player has pressed. We loop though our tile list and 
try to move each tile. If we find it can move then we 
check the direction of movement. If it matches the 


direction that we are looking for then we have a match 


and we can initiate the animation to move the tile. 
Figure 5 shows this whole process, from key press to 
animation. Note that we are locking and unlocking 
the gameStatus while this is happening, to avoid 
multiple moves at once. 
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>STEP-16 

Time to scramble the cat 

The game is not much fun if we start witha 
completed puzzle, so we need to add a system for 
mixing up the tiles. There are various ways we could 
do this, but we thought it might be quite nice if we 
start the game with the tiles being scrambled move 
by move. We can do this by simulating key presses 
using the same functions as in the previous steps. We 
can use a new gameStatus of 2 to indicate that the 
player can’t interact, then cycle through a predefined 
or random set of simulated key presses until 
everything is jumbled up. We have used a predefined 
list in this case. 


>STEP-17 

How scrambled is scrambled? 

For our scrambling, we can have a list of 
movements. If we alter the number of movements 
we are using then the game becomes more or 

less difficult. We can start at 30 and see how that 
works. Our scrambling function, scrambleCat(), 
calls the findMoveTile() function and uses the 
scrambleCountdown variable to check if we have 
made enough moves. After each animation, we are 
using a bit of a cunning trick: we always call the 
releaseLock() function after an animation so 
we can slip ina test to see if gameStatus is 2 and if 
so, call scrambleCat() again. See Figure 6 for the 
scrambleCat() function. 


>STEP-18 

Have we won yet? 

At some point in the game, there is a slim chance 
that the player will actually rearrange the tiles back 
into the correct order. We will need to write a check 
to see if this has happened each time a tile has been 
moved. We know that the positions of the tiles were 
correct before we scrambled them, so what we can do 
is make a list of the x and y co-ordinates of each tile 
when we first make the tile Actors. Then all we need 
to do is to compare that list with the current x and 

y values of our tile Actors and if they all match, we 
have a winner! 


>STEP-19 

Finishing touches 

You can see from the full program listing the 
checkSuccess() function and how that works, 
and we can also add some text prompts into our 
draw() function based on the value of gameStatus. 
That’s about it! We have a working Scrambled Cat 
game. You may want to add some features such 
as a score based on how many moves the player 
makes, or you may want to change the images. 
You could have scrambled egg or a scrambler bike 
or make the tile matrix larger for an even more 
difficult challenge. 
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@58. def checkSuccess(): 
SCP py @59. for t in range(15): 


060. if(tileList[t].x != correctList[t][@] or 
001. import pgzrun tileList[t].y != correctList[t][1]): 
@02. WIDTH = 800 061. return @ 
003. HEIGHT = 600 062. return 3 # we have success! 
004. gameStatus = 0 063. 
@05. tileList = [] 064. def makeTiles(): 
@06. correctList = [] 065. global tileList, correctList 
@@7. scrambleCountdown = 30 66. xoffset = 251 
@@8. scrambleList = [2, 0, 2, @, 3, 1, 1, 1, 3, @, @, 2, 1, 2, 1, 067. yoffset = 151 
By By Oh On Oy 2a Oy Py By ty Bly ly Sh ce ly I 068. x=y=c=20 
ee@9. 69. while y < 4: 
010. def draw(): # Pygame Zero draw function 70. while x < 4: 
e11. global gameStatus e71. ahi <¢ uls))e 
@12. screen. fill((141, 172, 242)) Q72. tileList.append(Actor("img"+str(c), pos = 
613. screen.blit(‘board', (150, 5@)) (xoffset+(x*100) , yoffset+(y*100)))) 
e14. for t in range(15): 073. correctList. append ((xoffset+(x*10@) , yoffset 
615. tileList[t].draw() +(y*10@))) 
e16. if (gameStatus == 3): screen.draw.text("Success!" 074. c+ 1 
, (315, 20), owidth=0.5, ocolor=(255,255,255),, 075. xX t= 1 
color=(128,64,0) , fontsize=60) 076. x =¢ 
Q17. if (gameStatus == 2): screen.draw.text("Please wait 077. yt=1 
while we scramble the cat", (135, 540), owidth=0.5, 078. scrambleCat() 
ocolor=(255,255,255), color=(128,64,0) , fontsize=4@) 79. 
018. if (gameStatus <= 1): screen.draw.text("Click on a tile 80. def scrambleCat(): 
to move it or use the arrow keys", (95, 540), owidth=0.5, Q81. global gameStatus, scrambleCountdown, scrambleList 
ocolor=(255,255,255), color=(128,64,0) , fontsize=40) 82. tileDirs = ["left", "right", "up", "“down"] 
e19. 83. if(scrambleCountdown > @): 
@20. def update(): # Pygame Zero update function 84. mt = False 
e21. if (gameStatus == @): e85. while(mt == False): 
22. if keyboard.left: findMoveTile("left") 86. mt = findMoveTile(tileDirs[scrambleList[scramble 
23. if keyboard.right: findMoveTile("right") Countdown] ]) 
24. if keyboard.up: findMoveTile("“up") 087. scrambleCountdown -= 1 
@25. if keyboard.down: findMoveTile("down") 088. gameStatus = 2 
26. 89. else: 
@27. def on_mouse_down(pos): e90. gameStatus = @ 
28. if (gameStatus == @): e91. 
@29. doLock() 92. def moveTile(tile): 
@30. for t in range(15): e93. borderRight = 551 
31. if tileList[t].collidepoint(pos): e94. borderLeft = 251 
32. m = moveTile(tileList[t]) e95. borderTop = 151 
@33. if(m != False): e96. borderBottom = 451 
34. animate(tileList[t],on_ e97. rValue = False 
finished=releaseLock, pos=(tileList[t].x+m[1], tileList[t]. 9098. if(tile.x < borderRight): # can we go right? 
y+m[2])) e99. tile.x += 1 
35. return True 100. if(not checkCollide(tile)): rValue = "right", 100, @ 
036. releaseLock() 101. tile.x -= 1 
37. 102. if(tile.x > borderLeft): # can we go left? 
638. def findMoveTile(moveDirection): 103. tile.x -= 1 
39. doLock() 104. if(not checkCollide(tile)): rValue = "left", -100, @ 
040. for t in range(15): 105. tile.x += 1 
041. m = moveTile(tileList[t]) 106. if(tile.y < borderBottom): # can we go down? 
042. if(m != False): 107. tile.y += 1 
043. if(m[@] == moveDirection): 108. if(not checkCollide(tile)): rValue = "down", @, 100 
044. animate(tileList[t],on_finished=releaseLock, 109. tile.y -= 1 
pos=(tileList[t].x+m[1], tileList[t].y+m[2])) 110. if(tile.y > borderTop): # can we go up? 
45. return True 111. tile.y -= 1 
046. releaseLock() 112% if(not checkCollide(tile)): rValue = “up", @, -100 
047. return False 113. tile.y += 1 
048. 114. return rValue 
049. def releaseLock(): a5 
@50. global gameStatus 116. def checkCollide(tile): 
51. if(gameStatus == 2): scrambleCat() 117. for t in range(15): 
52. else: gameStatus = checkSuccess() 118. if tile.colliderect(tileList[t]) and tile != 
53. 119. tileList[t]: return True 
@54. def doLock(): return False 
@55. global gameStatus 120. 
56. gameStatus = 1 121. makeTiles() 
@57. 122. pgzrun.go() 
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Need 


>12V Adafruit 
3-Way Tower 
Light 
magpi.cc/ 
OUocBH 


>12V 2APSU with 
barrel connector 
magpi.cc/ 
VhOBJY 


> Automation 
PpHAT 
magpi.cc/ 
RhPiSs 


> Wide Input 
SHIM (Optional) 
magpi.cc/ 
RWEDNE 


The light takes its power from 
the Wide Input SHIM, so only 
one PSU is needed 


The Automation pHAT 
allows the safe switching 


of 12V lights 


PJ EVANS 


PJ is a software engineer who runs 
the Milton Keynes Raspberry Jam. His 
home automation projects have got 
completely out of hand. 
mrpjevans.com 
twitter.com/mrpjevans 


Always yelling ‘Dinner!’ toa 
teenager or shed-dweller? Save your 
vocal cords by installing a tower light 
you can control from your phone 


f you’re blessed with teenagers or others who 

like to lock themselves away in their room/ 

shed/craft-room, you may well be fed up with 
shouting up the stairs or out into the garden when 
you need their attention, especially if headphones 
are involved. Why not signal your loved ones visually 
from your phone using a cheap industrial tower light, 
a Raspberry Pi, and some Python? You’ll learn about 
interfacing the Pi with normally incompatible devices 
and how little code is required to create a web server. 

This project was inspired by James West’s klaxon: 

jameswest.site/the-tea-time-klaxon. 


Get your Pi ready 

This project can be built using any 40-pin version 

of the Raspberry Pi capable of WiFi and it’s perfect 

for the Zero W. Once complete, the tower can run 
‘headless’, so no monitor or keyboard will be required. 
Raspbian Lite is ideal for this as there is no need fora 
fancy user interface. 

Start by installing Raspbian Lite on your microSD 
card (see magpi.cc/etcher), then booting up and 
running sudo raspi-config. Get WiFi set up and 
under ‘Interfacing’, make sure both ?C and SSH 
are enabled. Finally, set the Pi’s host name under 
‘Networking’ as we’ ll need it later on. 


Prepare the Wide Input SHIM 

So we can safely power the lights and the Raspberry 
Pi from a single 12 V PSU, we’re using the Pimoroni 
Wide Input SHIM, a tiny power regulator for the Pi. 
To power the lights, we’re going ‘tap’ the SHIM to 
get a12V feed by using the on-board power inputs as 
a supply. Carefully solder two wires to the positive 
and negative pads on the SHIM. We don’t want them 
shorting out on the Pi when the SHIM is in place, 
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Aclose-up of the Wide Input SHIM. Here 
you can see the positive and negative 
pads from which we take the 12V current 


so make sure the solder points are trimmed back as 
much as possible and covered with insulation tape. 


>STEP-03 

Install the Wide Input SHIM 

The Wide Input SHIM mounts on the first twelve pins 
of the GPIO. It is intended to sit flush at the base of 
the pins, so HATs can still be used on top. Therefore, 
the board needs to be precisely soldered directly on to 
the GPIO pins. 

Place the SHIM onto the GPIO pins, aligning with 
physical pin 1 (see photo). Secure with masking tape 
and solder into place starting with pins 1 and 12, then 
you can remove the tape. Take your time. You should 
now be able to power up your Pi using the barrel 
connector and 12V supply. 


>STEP-04 

Add the Automation pHAT 

Although we can now power both the Pi and the lights 
from a single 12V supply, the Pi cannot switch the 
lights directly without releasing the magic smoke. 
Pimoroni’s Automation pHAT is a general-purpose 
collection of inputs and outputs for projects such as 
this one. For our lights, it features three switchable 
outputs that can handle 12 V just fine. 

You’ll need to solder the supplied GPIO connector 
and the screw terminals to the pHAT. Check and check 
again that the orientation is correct. Once ready, 
attach the pHAT to the Pi with the Wide Input SHIM 
sitting in-between. 


>STEP-05 

Wire up the tower light 

Now our control device is complete, we can attach 
the tower light itself. There are five wires: one for 
each colour, a buzzer (that we’re not using), and 12V 
in. Following the diagram, connect the wires to the 
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The Wide Input SHIM is soldered directly to the 
GPIO pins so the pHAT can sit on top. Note the 
12V feed we're taking from the board 


Automation pHAT. The brown wire is the power in, 
so we connect that to the 12 V feed we took from the 
SHIM earlier. The three colour wires (red, yellow, and 
green) are connected to the three screw terminals 
labelled ‘Output Sinking 24V’ on the pHAT. Finally, 
the earth wire from the SHIM needs to connect to the 
earth on the pHAT. 


>STEP-06 

Install Automation pHAT software 

Your hardware is ready, so it’s time to get some code 
running. Power up and, from the command line, 
make sure you’re up to date with sudo apt update 
&& sudo apt upgrade. Pimoroni takes away all the 
pain of installing drivers for the Automation pHAT by 
providing a simple one-line install: 


curl https://get.pimoroni.com/ 
automationhat | bash 


If soldered 
correctly, the 
SHIM should not 
interfere with 
Automation pHAT 


SOLDERING 
THE SHIM 


When 
attaching the 
SHIM, use a 
thin tip on your 
iron and be 
very careful 
not to touch 
components 
on the Pi. 
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CAREFUL 
WITH THAT 
POWER! 


When using 
the SHIM, do 


not attempt 
to power the 
Pi using a 
regular USB 
supply at the 
same time. 


229692399" 
2379969939548 339008% ce) 


TION PHAT iui 


99243°379 


)° weapimoroni.com 


Here's how all our devices connect. The SHIM provides the power, 
then the Automation pHAT safely switches the 12V current 


The script takes a few minutes to run. Once 
completed, allow it to reboot the Pi (if required) and 
then you’re ready to try things out. 


cd ~/Pimoroni/automationhat/examples 
python output.py 


Do you see two blinking lights on the tower? If so, 
it’s all working. Press CTRL+C to stop. 


>STEP-07 

Install Flask 

There are many options for remotely controlling 

the lights, such as Twitter or even email. One of 

the easiest is to run up a Simple web server on the 
Raspberry Pi itself. To keep the code as simple 

as possible, we’ll use the Flask web application 
framework for Python, which does all the heavy lifting 
for us. Installation is as simple as: 


sudo -H pip install flask 
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Each line from the light is 
connected to one of the 
three ‘output’ terminals. 

The ground from the 
SHIM connects to the 
ground on the pHAT 


>STEP-08 

Code! 

From the /home/pi directory (if you’re not sure, 
just type cd followed by RETURN), issue the 
following command: 


mkdir ~/towerlight && cd ~/towerlight 
Now create a new file: 


nano towerlight.py 


Enter the code shown here (or you can download it 
from GitHub). Save the file (CTRL+X, then Y). When 
run, this script will fire up a basic web server. 

The code uses the Flask and Automation pHAT 
Python libraries to allow simple switching of the 
output terminals, allowing the individual lights on the 
tower to illuminate. Every time a web request comes 
in, all the outputs are switched off, then the selected 
one is illuminated. 


>STEP-09 
Testing time! 
To start the web server, just run: 


python ~/towerlight/towerlight.py 


You’ll see a few announcements on screen 
and then it will wait for requests. Using the host 
name you set earlier, or the IP address of the 
Raspberry Pi (you can run ifconfig to discover 
this), go to http://hostname.local:5000/ or 
http://ip-address:5000/ from any web browser. 
If the ‘.local’ address does not work and you’re on 
Windows, you may need to install Apple’s Bonjour 
Services (magpi.cc/JSUBrT). 
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e 
The simple website you should now see allows you towerlight - py 


to switch each light on and off by clicking the links. >PYTHON 
Q@1. import automationhat 
>STEP-10 lag eS Pern DOWNLOAD: 
+ Trom Tlask impor as magpi.cc/Uayjbk 
Start on boot 04. app = Flask(__name_) 
To start the web server whenever we boot the Pi, we es. 
need to create a service file: @6. # Generate a simple HTML page. You could also use Flash's built-in 
Jinja Templating. 
y . 67. def makePage(body): 
sudo nano /1ib/systemd/system/towerlight. 8. maciiay OES 
service @9. <!DOCTYPE html> 
10. <html> 
; : all <head> 
And populate it as follows: 12. <meta name="viewport" content="width=device-width, 
initial-scale=1.0"> 
[Unit] 13. </head> 
Description=TowerLight a ee ee COC Ye. 
4 4 <hr/> 
After=multi-user.target 16. Aerts 
17. <li><a href="red">Red</a></1i> 
[Service] 18. <li><a href="yellow">Yellow</a></1i> 
Type=idle 19. <li><a href="green">Green</a></1i> 
A 20. <li><a href="off">Al1l Off</a></1i> 
ExecStart=/usr/bin/python /home/pi/ 21 ee oS 
towerlight/towerlight. py 22. </html> 
23% sae 
[Install] ae : ; : d : 2 
=multa 25. # This function runs every time a request is received before routing. 
WantedBy=multi-user. target 26. # We switch off all the lights here. 
27. @app.before_request 
Now, install the service: 28. def alloff(): 
295 automationhat.output.one.off() 
: 30. automationhat.output.two.off() 
sudo chmod 644 /lib/systemd/system/ etl automationhat.output.three.off() 
towerlight.service 32. 
sudo systemct1 daemon-reload 33. # Our default home page 


34. @app.route('/') 

35. def index(): 

36. return makePage( 'Index') 

The server will now start automatically on reboot. 37. 

38. # The next three functions switch on the three lights 


>STEP-11 39. @app.route('/red') 


40. def red(): 


sudo systemctl enable towerlight.service 


Assemble! 41. automationhat.output.one.on() 
Once you’re happy with testing, you can shorten the 42. return makePage('Red') 

leads as you see fit. It’s straightforward to mount the papeircut: Cielo") 

tower on top of a small project box and feed the wires AS. Ree veriont) i 

through. Mount the Pi inside with hot glue or sticky 46. automationhat.output.two.on() 
pads, with the large barrel connector lead supplied 47. return makePage('Yellow' ) 
with the SHIM accessible from the outside. aE 


49. @app.route('/green') 


Congratulations, you now have the perfect teenager/ 50. def green(): 
shed-dweller alerting device in a single unit that can 51. automationhat.output.three.on() 
be controlled from your phone or any web browser. 52. return makePage('Green' ) 
Bae 
by 54. # Switch everything off 

>STEP 12 55. @app.route('/off') 
Make it your own 56. def of f(): 
What we’ve made here is fairly basic, so there’s lots 57. return makePage(' Off") 

; ; : ; 58. 
es poe en ny ol ey atovine ae webewedad 59. # Let's announce ourselves by making the lights blink 
learning about Flask templates? How about a disco 6@. automationhat.output.one.on() 
mode? The tower comes with a (very loud) buzzer; could 61. time.sleep(@.2) 
you add it in? What are the other things that could 62. automationhat .output.one.off() 


63. automationhat.output.two.on() 


i i 2 i 2 2 
trigger the lights Twittere A ten buttons Also, 64. time.sleep(e.2) 
don’t forget there are plenty of inputs to play with on 65. automationhat.output.two.off() 
the Automation pHAT, so the lights could also react to 66. automationhat.output.three.on() 
sensors. Check out magpi.cc/TSEFXL for an alternative 67. time.sleep(@.2) 
‘ ; 68. automationhat.output.three.off() 
version of the klaxon software with extra features. 69 


7®. # Start the web server on port 5000 
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to automate 


MORE 
CRONTAB 
OPTIONS 


Using nano to 

edit text within the 
Terminal relies on 
using the keyboard 
without the mouse 


GARY PICKUP 


An experienced IT Consultant who 
enjoys all things geek and sharing 
knowledge, who once appeared in 
a Marvel comic book. 
geektechstuff.com 
twitter.com/geektechstuff 


AN INTRODUCTION TO 


Ever find yourself loading the same webpages around the same 
time daily for a catch-up on the latest Raspberry Pi news? 
Get your Pi to do it automatically with cron 


ron is a piece of software that is built into 

the Raspbian operating system and is used to 

schedule (automate) tasks to run at different 
intervals (e.g. every five minutes), times, or dates. 
Cron was originally designed to automate system 
administration within UNIX systems; however, due 
to its diversity, we can use it within Raspbian to 
automate tasks such as opening applications, loading 
webpages, and running Python scripts. 


Launch Terminal 
To configure cron, we will be using a text editor 
within the Terminal — the latter can sometimes seem 
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daunting, but it opens up lots of possibilities and 
access to utilities like cron. To quote Douglas Adams, 
‘Don’t panic!’ By default, the Terminal has a shortcut 
at the very top of the Raspbian desktop; click it to 
receive a prompt that says pi@raspberrypi: — and it’s 
time to start. 


Launching cron 

Cron is configured via files called crontabs. Each user 
account on the Raspberry Pi can have its own crontab; 
however, this tutorial will be dealing with creating a 
crontab for the default Pi user. At the pi@raspberrypi: 
prompt, type crontab -e. the ‘-e’ is very important 
as this tells Raspbian that we want to edit our crontab. 
The Terminal will output ‘no crontab for pi — using 
an empty one’; this is because we are creating our 
first crontab. 


Welcome to your first crontab 

The Terminal will open a crontab in the default 

text editor, which for Raspbian is nano. Nano uses 
keyboard combinations to save and exit files, unlike 
graphical text editors where clickable menus are 
used. The crontab already contains a lot of text that 
has been commented out using hashes (#); this text 
is an introduction to cron and worth reading. Once 
read, use the down arrow on the keyboard to get to 
bottom of the file, just below them h dom mon dow 
command line. 
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Cron can be used 
to schedule a web 
browser to open 


Cron tasks are text lines that 
tell cron what to do and when 


pi@raspberrypi: ~ 


WITH A 12 MONTH PRINT SUBSCRIPTION 


Scheduling a task 

The m (minute) h (hour) dom (date of month) mon 
(month) dow (day of week) command line gives a fleeting 
look at how cron can schedule a task. We will be using 
it to open our favourite website at 7.30am daily, but 
this could very easily be 7.30am every Thursday, or on 
the first day of every month. When writing a value for 
these options, we must provide either a number or an 
asterisk (*). The * means any. 


Let’s launch a web browser 
To launch a web browser at 7.30am every day, we need 
to enter the following line of text: 


30 7 * * * export DISPLAY=:@ && chromium- 
browser https: //www.raspberrypi.org/magpi/ 


This line says at 30 minutes past the seventh hour 
on every day of every week in every month, run 
the command export DISPLAY=@ && chromium- 
browser, which opens the web browser Chromium and 
tells it to open the website raspberrypi.org/magpi. The 
export DISPLAY=:@ && part is required to make sure 
cron displays the web browser on screen. 


Saving the crontab 
Once the line of text has been entered, we need to save 
our crontab. Unlike a graphical word processor, nano 
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Don't worry about the name, 
as Raspbian will name the 
crontab appropriately 


require 
the cro 
file opt 


s that keyboard combinations are used to save 
ntab and exit. Press CTRL+O to open the save 
ion, and then press ENTER to save the crontab. 


Don’t worry about the name, as Raspbian will name 


the cro 
press C 
and wa 
schedu 


There 


ntab appropriately. With the crontab saved, 
TRL+X to exit nano. You can now sit back 
tch as cron runs your automated task at the 
ed time. 


t Tabs Hel CRON 
SHORTCUTS 


are various crontab commands available to edit, 
list, or delete the tasks that cron has been asked to do 
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ON THE RASPBERRY PI 
PART 09 


It’s time to go a bit retro and make our game look better 


e’ve done most of the ‘hard’ work so far: There’s a very good reason in this game why we 
we have enemies, we have control, we can kept our window to a size that would allow us to see 
eo assieds interact with our map, and we are almost the whole game: it allowed us to see the whole game! 
i cade’ apt-get ready to interact with our baddies. But as a game, it’s That might seem very obvious, but if we had reduced 
codeblocks dull: one big window with the whole game visible. the view area to a window, it would mean we’d have 
> FreeTypez That’s not how we remember our old retro games. to actually play the game so we could get to a point 
; It’s time to consider the appeal of our game and where we could see if our characters were behaving 
> stb_image.h ‘ ; ) . 
isee last issue) make changes to the display and the map, to create as we expected. At the moment, while they’re a bit 
satisfying gameplay. small and hard to distinguish, we can comfortably see 


Scaling up 
the graphics 


USE 
SWITCHABLE 


VIEWS 


ww 
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that all the enemies are where we expect them, and do 
what we expect of them. 


Step through it 
A second point is much harder to get excited about, 
as for the most part you’ve had code to download 
which you knew was working, so there would be 
little reason to actually inspect and step through 
your code. But it is an important thing to be able to 
do. This is one reason why most coders like to use 
two systems to work on: one to edit, compile and 
debug, and one to run on. This is possible using two 
Raspberry Pi systems or a PC and Pi, but it does need 
a bit of setting up — we will cover this another time. 

Back to viewing the whole game. What we are in fact 
currently doing is visualising the whole of the play 
area, or map. We’ve allowed our map co-ordinates to 
directly reflect our screen co-ordinates, but we have 
the capacity to scale things up and view a window into 
our map that we can drag along with our player. 

But before we can do that, we need to acknowledge 
that some things we did previously to make life easy 
for us are now going to bite us. 


Magic numbers are bad 

We’ve mentioned before, mostly in the code, that 
hard-coding our tile sizes to actual numbers like 16 
isn’t a good idea. Yes, it’s the actual number of pixels 
the image has, but now we have a predicament: if 
we’re going to scale up the visuals to allow for 64x64 
pixel tile size, we have to go through all our code and 
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take note of every use of the number 16 as it relates 
to the size of a tile, and change it manually (Figure 1). 

We can’t just do a global find and replace, because 
there are some cases where the number 16 is actually 
fully legit. We are still interacting with our map using 
1616 tiles; it’s only the display that will change. 
These so called ‘magic’, or hard, numbers are very 
prone to error if you miss one when trying to change, 
and it’s rather tedious to go through an entire project 
checking and changing every instance, once it gets 
beyond a certain size. 

This is where we need to use one of the standard 
concepts of C/C++ to define our value in a way that’s 
easy to change. 


#define A_CHANGEABLE_VALUE 16 


Now in your code when you are referring to the 
magic value, use the label A_CHANGEABLE_VALUE, 
which gives us a nice helpful way to alter things 
because you only have to change the #define once! 

The Game.h file has set the size of the tiles asa 
#define; since they are square, we use the same value 
for x andy sizes. Try altering the sizes and you will see 
that one change allows you to have any size of screen. 
Don’t make it too big, though: since our original 16 
size was only 16x16 pixels, you can see our scaling is 
stretching things quite a bit. 

We can also scale up our sprites using a similar 
system, as a proportion of our actual tile sizes vs our 
image size. 


Figure 2 Full- 
screen glory, but 
where's Bob? 


LOAD ONLY 
WHAT YOU 
NEED 


We will cover 
this in more 
detail next 


time, but take 
a small note of 


how much you 
are loading 
and how often. 
Be aware of 
things like this. 
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AVOID 
MAGIC 
NUMBERS 


If you are likely 
to change a 
value, don't 
hard-code 

it. Magic 
numbers 

can cause a 
lot of bugs 
when you find 
you have to 
change them. 


Figure 3 Drag the 
screen along using 
fixed distances 


Now when we draw our tiles and sprites, we need to 
remember that our sizes and positions have to reflect 
these new scale values and they will therefore only be 
visible in the part of the screen we are focusing on, 
which sadly to begin with is going to be the top-left 
corner (0,0). 


OK screen, follow me 

Now we can display the screen any size we 

want, while the map is busy doing its updates 
independently. We want to get the screen to focus 

on our area of interest, namely where our player is. 
He has to be the controlling system that allows the 
screen to scroll around and lets us see what is directly 
around him. 

That’s not so hard to do. If we keep note of where 
in the map our player is, we can consider that the 
corner of the screen that we want to see is relative to 
his position; that is easy to calculate. 

Imagine Bob has a pole that’s a fixed length, and 
he ties it to the screen; as he moves, he pulls the 
screen ‘window‘ around with him, so the window 
itself has co-ordinates that start at a set distance 
behind Bob. We know that the corner of the screen 
will be a certain x distance away, and a certain y. 
Voila, we have the basics of a scroll system that 
centres on our main character (Figure 3). We can 
make minor adjustments to deal with the windows 
co-ordinates are at the edges of the map, and even 
make small allowances to allow Bob to move freely 
within a centre window area without scrolling. 
Check out the Bob class to see how that is worked 
out and passed back to the tile render system to 
reposition things. 


One more step to full arcade mode - and this is 
an easy one to do on the Raspberry Pi — is to set our 
screen to full. The Raspberry Pi range has a couple of 
nice features that let us ask the display code how big 
the screen is, which in turn lets us set the size. Set 
#define FULLSCREEN to true in Game.h, and see the 
result (Figure 2). 

There has been one niggle all through our 
development of our game. When we press the keys in 
our game, it often does something to folders or open 
projects on our desktop; we really should stop that. 
Because our OS is running, it is naturally going to read 
keys, but we saw early on that using the OS to read 
keys in our game wasr’t ideal. But having both our 
own key reader and the OS reader causes niggles. 

The redirection code can be found in the game 
startup code, and importantly the restore code as the 
game exits. We don’t really have to do that, but it’s 
good practice to leave our system as close to the way 
we entered it as we can. 


Finally some text 
Printing text is easy, isn’t it? We just use a printf 
function or a cout or some other variation. Hmm, well 
no, sending text to buffers and console display is easy, 
but actually putting the letters A-Z and numbers 0-9 
on screen in our game when we want it, at the right 
point, in the right colour, in the right size... no, that’s 
not actually easy at all. 
Text is funny stuff when displayed on screen. It 
comes in all kinds of shapes and styles, called fonts, 
all kinds of sizes, all kinds of emphasis. Even within 
a font there are all kinds of issues with the width of 
different letters. Consider W and I; W is one of the 


The Top Left 


Corner can be 


worked out 


I ra left corner with ease 
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widest letters in the Roman alphabet, I is one of the 
thinnest, but we want a word like WIDTH to keep 
the letters close together. We call that proportional 
spacing, where we keep the gap between letters toa 
comfortable minimum. W I DTH just looks wrong. 

We could just treat text like a sprite, keeping a 
suitable drawn tile for each letter and number in a fixed 
order which matches the standard ASCII character set 
system (A = 65, B = 66, etc.). But though simple, it’s 
rather an inflexible system and the font is also going to 
be a fixed size, so we have to make adjustments when 
drawing to keep the proportional spacing we desire to 
look good and if we want to use a different font, we may 
have to store new info on spacing. 

Oh, and we mentioned the Roman (also called Latin) 
alphabet — that’s the standard English alphabet — but 
there are several others: Cyrillic, Kanji, Arabic, etc. 
There has to be some kind of standard, though, which 
computers can use to display the same text in any 
chosen font or emphasis! The most common is the 
TrueType standard, which keeps all the data needed 
to proportionally space our letters, and info on any 
emphasis systems we want to use. 

There are many sites where you can download 
free to use TrueType fonts — a quick web search for 
free TrueType fonts will find dozens of sites you can 
browse for just the right font you want, but make sure 
it’s free to use. Once you download it, treat it like any 
other asset and load it as you need it. 

So, to repeat, printing text is not easy, not easy at 
all... it?s such a lot of work in fact, it’s in our interests 
to make use of code that’s been written by far more 
experienced people who actually enjoy working with 
such demanding tasks. 

There are many font-handling libraries around, 
some you have to pay for, but most are free. We’re 
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going to use a common free one that’s already on our 
Raspberry Pi, called FreeType. It’s fairly simple to use 
and once we have included the relevant files, we can 
let that library take the strain. 

Review the new Text class, which lets us use the 
FreeType lib in easy-to-understand ways. We also 
have a fair number of pre-installed fonts we can use, 
our demo will use what’s available on your Raspberry 
Pi. Just add /usr/include/freetype2 to your #include 
file list, and the library itself is called freetype. 

Now that we can print text, we can also use it to 
report on values in the game. Since our debugger is 
not so easy to use now, we are full-screen — but we’ll 
come to that soon, as we’re going to start holding back 
a little on providing fully working code so you can 
write your own. 

There are some interesting new concepts in our text 
shader and setups, not least of which is their use of a 
mathematical concept called a matrix. Now, these are 
truly wonderful things which have a tendency to scare 
beginners, but really all a matrix does is allow us to 
do all the maths we do in our current hacky shaders 
much faster. We’re going to discuss this properly in 
the next lesson. 


Next time 
Our main core of the game is done, but we don’t have 
a very organised game: there’s no intro; no menu; 
only one, rather bad level; our jumps and timing need 
tweaking; and we don’t as yet interact with other 
objects. Next time, we’ll correct these and add pick- 
ups and a score system, as well as introducing some 
concept of losing lives and game over. 

We’ll also take our first important steps in 
using matrices, and take a bit more care of our 
asset management. 
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NAME: 
MagPiHelloTriangle. 
cpp 
SimpleObj.h/cpp 
Game.h/cpp 
OGL.h/cpp 
Bob.h/cpp 
HideAndChase.h/ 
cpp 
PointToPoint.h/cpp 
Input.h/cpp 
Text.h/cpp 


DOWNLOAD: 
magpi.cc/MzGDri 


Figure 4 Here'sa 
very simple font 
display using an 
on-board font 


LEARN 
MORE 
ABOUT C 


Brian has a 
whole book 
on the subject 
of making 
games C and 


C++, called The 
Fundamentals 
of C/C++ Game 
Programming: 
Using 
Target-based 
Development 
on SBCs. Grab 
it here: 
magpi.cc/ 
nUKjEt 


rtm, 


THE FUNDAMENTALS OF 


C/C++ GA 
2 oS 


Grian Beuken ap 
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Tutorial 


JONATHAN PALLANT 


a A professional embedded systems 
programmer based in Cambridge, Pi 
Wars veteran, and member of the Rust 
Embedded Working Group. 
keybase.io/thejpster 


The cargo new command creates a new 
Rust crate. The --bin argument makes 
it a program, not a library 


Cargo automatically 
re-compiles your code 
when you try to run it 


cargo new --bin my_test_program 
(application) “my_test_program- 

cd my_test_progr@ 

i cargo run 

my_test_program v0.1.0 (file:///home/pi/my_test_program) 

dev [unoptimized + debuginfo] target(s) in 7.51s 
“target/debug/my_test_program’ 


READING SENSE 
HAT DATA WITH 


Want to learn a new programming language that’s ergonomic and safe, 
yet runs really fast? Dive in to Rust 


binary project 


Figure 1 A newly created Cargo crate 
contains a Hello World example program 


e’ve all heard about security bugs in programs 


rust-lang.org 


> Sense HAT 
magpi.cc/ 
sense-hat 


written in C, a language that dates back nearly 

50 years. Yet it remains the default choice for 
systems programming. In Rust, a new programming 
language from Mozilla, it’s almost impossible to 
introduce security flaws, yet the compiler produces 
fast machine code. To introduce you to Rust, we’ll walk 
through the installation of the compiler and a simple 
example program for the Sense HAT. 


listingI.rs 


// Here we access the crate we specified in Cargo.toml. 
extern crate sensehat; 


// The use statements pull some types into scope, to 
// save us some typing. 
use sensehat: :SenseHat; 


// main() gets called when we run our program 


fn main() { 


// The variable 'hat' represents our SenseHat. We mark 
// it mutable (otherwise it would be const, or read-only). 
let mut hat = SenseHat: :new().unwrap(); 

// Get the temperature and unwrap the result. 

let temp = hat.get_temperature_from_humidity().unwrap(); 
// Tell everyone how hot it is using the println! macro. 


printin! ( 


{} » temp); 
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Installing Rust 

Rust is fairly straightforward to install and has native 
support for the ARM processor in the Raspberry Pi. 

If you visit rust-lang.org and select Install Rust, 

it will prompt you to run the following command: 
curl https://sh.rustup.rs -sSf | sh. This 

will download and run the installation script, detect 
your Pi, and fetch the correct version of the compiler 
automatically. Just follow the on-screen instructions. 


Create and run your first program 

Rust programs and libraries are called ‘crates’ and are 
built using a tool called ‘Cargo’. Let’s ask Cargo to create 
anew ‘binary’ crate with a bare-bones example program 
inside, using the cargo new command (see Figure 1). 
You can give your new program any name you like, but 
make sure you use underscores instead of spaces. We 
can then enter the new folder that has been created and 
ask Cargo to run our program. Cargo correctly works out 
that our program must be re-compiled before it can be 


This is what listing1.rs should look like when you run it. 
This library defaults to using kelvin for temperature 


raspberrypi.org/magpi 


READING SENSE HAT DATA WITH RUST 


run and takes care of that for us. Compiling our code 
checks it for correctness and then converts it from the 
source code into a machine code file the computer can 
run, so it’s harder for bugs to hide in Rust, unlike Python 
where each line isn’t checked until it’s executed. 


>STEP-03 

Fetch some crates 

Rust gives you access to a range of software crates 
written by other Rust programmers, at crates.io. By 
making changes to our crate’s Cargo.toml file, we can 
tell Cargo we'd like to make use of one of these crates 
in our program. This saves us a bunch of typing, but 
it’s often better to build on the work of others. Edit 
the Cargo.toml file in your project’s folder in your 
favourite text editor (such as Geany) to add this line, 
under [dependencies]: 


sensehat = "1.0" 

Next time you build your code, this will pull in version 
1.x (anything compatible with 1.0) of your author’s 
Sense HAT driver from magpi.cc/issfxz. Because we 
used some other crates when writing this driver, when 
you next build, Cargo will automatically pull all of those 
in as well, and all the crates they need, and so on. 


>STEP-04 

Reading from the Sense HAT 

Our program lives in a file called src/main.rs. Let’s 
load that up, delete the ‘hello world’ example placed 
in there by default, and do something with our Sense 
HAT by copying the code in listing1.rs. We can run 
this again with cargo run and it should look like 
Figure 2. Don’t worry, it will only take a while to 
compile the first time around. 


>STEP-05 

Let’s loop 

Rust has all the usual programming language features 
like for loops and if statements. Let’s expand our 
program to wait until someone shakes our Pi, using the 
accelerometer function, and then print them a message 
on the LED screen - see listing2.rs and Figure 3. 


>STEP-06 

Read the docs! 

Hopefully we’ve given you a little taste for the Rust 
programming language and shown that it’s not much 
more complicated than Python or JavaScript. For 
further reading you can check out the Rust Book, 
which is available for free online at magpi.cc/HAoyYu, 
or as a printed copy from your favourite book vendor. 
If would like to do some experiments with LEDs and 
buttons, check out Rahul’s excellent port of GPIO Zero 
to Rust at magpi.cc/eYpDfk. You can also read the 
documentation for the sensehat crate, to find what 
other features it has to offer, at docs.rs/sensehat. 


raspberrypi.org/magpi 


listing2.rs 


// Here we access the crate we specified 
in Cargo.toml. 
extern crate sensehat; 


DOWNLOAD: 
magpi.cc/apkZUw 


// The use statements pull some types into scope, to 
// save us some typing. 

use sensehat::{Colour, SenseHat, SenseHatError}; 

use std::{thread::sleep, time: :Duration}; 


// We've declared main as returning a Result, which 
// means we can use the ? operator to bail out early 
// if our code finds any errors at run-time. 
fn main() -> Result<(), SenseHatError> { 
let mut hat = SenseHat: :new()?3; 
let temp = hat.get_temperature_from_humidity() ?; 
printin!("It's {} in here", temp); 
// Clear the screen 
hat.clear()?; 
// Instructions for the user 
printin! ("Shake me!"); 
loop { 
// Get the G readings from the sensehat 
let accel = hat.get_accel_raw()?; 
// Show them on screen in debug format. 
printin!("{:?}", accel); 
// Check if any acceleration value is too high 
if [accel.x, accel.y, accel.z].iter().any(|g] *g > 1.5) { 
// If so, print a warning message! 
hat.text("“Earthquake!", Colour: :WHITE, Colour::RED)?; 
// Pause on the final character 
sleep(Duration: :from_millis(1000)); 
// Turn the screen off 
hat.clear()?; 
I 
// Let our CPU rest for a short while to slow down 
// the output. 
sleep(Duration: :from_millis(250)); 
// Press Control + C to quit this loop! 


Figure 3 This Rust Sense HAT driver 
uses the same RTIMULib C++ library as 
the Python Sense HAT driver 
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YOUR QUESTIONS ANSWERED 


FREQUENTLY 
ASKED QUESTIONS 


NEEDA 
PROBLEM 
SOLVED? 


Email magpi@raspberrypi.org or 


find us on raspberrypi.org/forums 
to feature in a future issue. 


Your technical hardware and software problems solved... 


Basics with Scratch 

Depending on your skill level, the easiest entry point 
is Scratch. It uses programming blocks that you drag 
and drop with your mouse to create code you can 

see — this teaches you the basic structure and logic of 
coding, while also letting you see instant results for 
what you’ve done. 


Learning code 

The step above Scratch is actually typing out code in 
something like Python. It’s quite easy to read and 
understand and, like Scratch, lets you see the results 
of your work pretty quickly. You can find lots of 
Python tutorials in The MagPi’s archives and on the 
Raspberry Pi projects site: rpf.io/projects. 


Programming objects 

Once you’re confident enough with making programs 
in Python, you can then graduate to controlling 
different components and reading from sensors. This 
can be as simple as turning on an LED hooked up to 

a Pi, or more complex, like recording environmental 
data to control a robot. 


IDLE 

IDLE is the default IDE (integrated development 
environment) that comes with Python. It lets you 
write your code and test it quickly without having to 
compile it into software. It offers basic debugging 
of your code, and it’s a lot better than just typing 
something into a text document. 


Thonny 
Thonny comes with Python 3.6, and has been 
developed to be a lot easier to use for beginners 
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compared to IDLE. It includes the shell and code in 
one window, and gives you info on variables in extra 
columns around the interface — almost everything 
you'll need to know at a glance. 


Mu 

Designed for true beginners in mind, this new option 
is meant to be the first Python IDE to use. It offers 
specific modes to make coding your project easier — 
you can select standard Python, or even a Pygame Zero 
mode to make some games with. 


Anything you desire! 

All modern programming languages are available to 
use on the Raspberry Pi, such as C, C++, Ruby, and 
JavaScript. You may need to install extra software to 
truly get the most out of them, but a quick Google 
search will help you there. 


Node-RED 

This programming language uses Node blocks to 
create code, somewhat similarly to Scratch, albeit 
designed with creating the code as a workflow. 
It’s very powerful and has been used to animate 
dinosaurs, hack Minecraft, and much more. 


Wolfram Mathematica 

Wolfram and Mathematica are supplied for free in 
Raspbian and allow you to do some serious coding 
with access to a lot of data. We’ve seen them used for 
wonderful graph plots that look like pieces of art, as 
well as making it simple to mod Minecraft Pi and post 
to Twitter. 


® python 
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WHAT IS THE USER NAME AND PASSWORD 

FOR THE RASPBERRY PI? 

The default user name for Raspbian is pi and the default 
password is raspberry. If this does not work, check the 
information about your specific operating system on the 
downloads page (magpi.cc/1MYYTMo). 


WHY DOES NOTHING HAPPEN WHEN I TYPE IN 

MY PASSWORD? DID MY RASPBERRY PI FREEZE? 

To protect your information, Linux does not display 
anything when you are entering passwords in the Bash 
prompt or the Terminal. As long as you were able to see 
the user name being typed in, your keyboard should be 
working correctly. 


HOW DO I CONNECT A MOUSE AND KEYBOARD? 

The Model A/A+ has one USB port, the Model B has two 
ports, and the Model B+, Pi 2 Model B, and Pi 3 Model B/ 
B+ have four ports. These can be used to connect most 


USB 2.0 devices. Additional USB devices such as mice, 
keyboards, network adapters, and external storage can 
be connected via a USB hub. The Pi Zero and Pi Zero W 
have a single micro USB port; this requires a USB OTG 
cable to connect devices such as keyboards or hubs. 


WHERE IS THE ON/OFF SWITCH? 

There is no on/off switch! To switch on, just plug it in. 
To switch off, if you are in the graphical environment, you 
can either log out from the main menu, exit to the Bash 
prompt, or open the Terminal. From the Bash prompt 
or Terminal, you can shut down the Raspberry Pi by 
entering sudo halt -h. Wait until all the LEDs except 
the power LED are off, then wait an additional second 
to make sure the SD card can finish its wear-levelling 
tasks and write actions. You can now safely unplug the 
Raspberry Pi. Failure to shut the Raspberry Pi down 
properly may corrupt your SD card, which would mean 
you'd have to re-image it. 


Having trouble with The MagPi on the App Store or Google Play? 


Here are your most common questions answered. 


How do | find The MagPi on Google Play or the App Store? 
Allyou have to do is go to the search bar and type ‘The MagPi’ 


or ‘Raspberry Pi’ to find us. 


I've subscribed to the digital edition and | can't sign in 


to restore my purchases. Please help! 


Since your The MagPi purchases are linked to your Google or Apple 
accounts, there's no need to sign in at all. If you'd like to re-download 


RUN ANDROID 
ON RASPBERRY PI 


iC: TI 


t 
CARD COUNTER 


e. 
BUILD A = 
WILDLIFE CAMERA = 
& ae HERE COMES 
a jUN 
a ADD A! 


y ENSORFLOW 


your purchases on your current device, or make your purchases 
available on other devices, all you need to do is hit Menu on the home 


screen, then Restore Purchases on the sidebar. 


How can I search the digital magazine for keywords? 


Finding direct references is really easy with The MagPi app - 


GET ITON 


> Google Pla 
g y 


all you have to do is tap the screen to get the app’s GUI to show, 
and then press the small magnifying glass icon in the top-right 4 ‘Available on the 


corner of the screen. Now, just type in your search term to find the 


relevant results. 


raspberrypi.org/magpi 


@ App Store 
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SECURE 


OUR HOME 


WITH RASPBERRY PI 


MAKE YOUR HOUSE SAFER WITH THESE SIMPLE PI PROJECTS 


ome security is important. Whether you live 
@ in a high-crime area or are currently at a bad 
time in your life, feeling safe in your own 
home is essential. The Raspberry Pi can help you here. 
With the rightt tools you can set up a CCTV 
network. Or have a special doorbell that lets you know 
whenever someone is at your door, whether you’re at 
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home or not. Over the next few pages we’1l delve into re 

these kind of projects that you can make much more i | 

cheaply than a home security system. gE 
Of course, you could also use all of the above to keep P 

an eye on your cat during the day, or make sure you hear 4 

the postman. However you want to use it, make sure to 

have a spare Raspberry Pi handy, and let’s get started. 


raspberrypi.org/magpi 


SECURE YOUR HOME WITH RASPBERRY PI fagyetli//4 


RASPBERRY PI 
HOME CCTV 
NETWORK 
DOOR 
SECURITY 
MONITOR 


AMAZON 
DASH BUTTON 
DOORBELL 


raspberrypi.org/magpi 


@ Unlocked 470% 62% /_ ) 


14:59 


Wednesday 18 July 


PUSHOVER 


Door opened! 


The door is open! 
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RASEBERKY Pl 


NETWORK 


Combine multiple Raspberry Pi boards and their Camera Modules 


ome CCTV systems and IP cameras are 

becoming increasingly popular nowadays, but 

can be expensive to buy and install, especially 
for multiple cameras. In this guide, we’ll show you 
how to use multiple Raspberry Pi boards and their 
Camera Modules to create a home CCTV network using 
motionEyeOS, so that you can keep an eye on your 
home at all times. You can even be alerted whenever 
any of your cameras detects movement, so that you 
never miss anything! 


mm Every camera you want to include in 
your Raspberry Pi home CCTV network must 
be running motionEyeOS. Download the image 
Ms based on the Raspberry Pi model you are using 


First things first, doyntca—$——— 


motionEyeOS and flash it to 
your microSD card. We like 
Etcher as it’s quick and easy 


1ODOSBSORBON| |" 498000808100 SSTeH® 2p 


i to create a home CCTV network using motionEyeOS 


Preconfigure your WiFi access by 
creating a wpa_supplicant.conf 
file that is placed in the boot 
partition of your microSD card 


and then flash it to the microSD card. We love 
using Etcher as it is simple to use and works 
with compressed image files, but you can 
do this any way you like. Don’t boot your Pi 
just yet, though, as we need to preconfigure 
the WiFi connection. 

"URE YOUR 
mi If you are running motionEyeOS on 
a Pi Zero W, you will need to preconfigure the 
WiFi connection before booting for the first 
time. Using a text editor, create a file called 
wpa_supplicant.conf, then add your network 
credentials (more information can be found here: 
magpi.cc/BrUXgR). Save the file and then copy 
it to the boot partition on your Pi’s microSD card 
— we will reuse this file for the other Pi boards as 
we add them, to save repeating this every time. 


We'll use the first Pi as our ‘master’. The first 

boot can take longer as motionEyeOS will 
optimise the microSD card. Access the motionEyeOS 
interface by going to the Pi’s IP address, where you 
should be greeted with a login prompt. Use admin as 
the user name; the default password is blank. 


Repeat Steps 1 and 2 on each additional Pi 

you want to add. They should all be running 
motionEyeOS, be connected to WiFi, and you should 
be able to access motionEyeOS on each using its IP 
address — if not, double-check that you added the 
wpa_supplicant.conf file to the boot partition and try 
again. Now log back in to the ‘master’ CCTV Pi and 
click on the three horizontal blue lines in the top-left 
corner. Next to that is a drop-down menu ~ select 
‘add camera’ and in the Camera Type, select ‘Remote 
motionEye Camera’. Enter the remote camera’s IP 
address, user name (admin), and password (blank), 
and you should be able to select the camera. Do this 
for each additional camera you have set up earlier. 


Once you have added your cameras to the 
‘master’ CCTV, you should see them in the live view 
on motionEyeOS accordingly. Congratulations! Now 
you can customise and configure each camera from 
the ‘master’. You may want to name each camera, as 
well as tweak the resolution, or even add email alert 
notifications when motion has been detected. Your 
home CCTV system is now complete! 


192.68.087 


Add Camera. 


Add your additional remote 
motionEyeOS cameras using their 

IP addresses, user names (normally 
admin), and passwords (normally blank) 


The official Pi Zero Case 
is perfectly suited to the 
Camera Module 


Awide-angle lens 
is inexpensive and 
enhances the field 
of view on the camera 


The Pi Zero W is 
a great choice 
due to its size 
and wireless 
capabilities 


The magnet is 
atta ched to the 


MONITOR 


Connect magnetic door security switches to or closed and receive notifications via motionEyeOS 
your Raspberry Pi and receive notifications and Pushover too? In this guide, we will show you how 
when they are opened, via motionEyeOS 


to do just that! 


opefully, you saw how simple it is to LC, 
use multiple Raspberry Pi cameras with : Before you connect everything to the 


motionEyeOS to create a home CCTV system door or window you want to monitor, it is best 
in the last guide. Why not go one step further by using to test the circuit first. Use a breadboard and 
the Raspberry Pi’s GPIO to monitor simple magnetic connect a jumper jerky cable to the 3V3 pin on 
reed switches to see whether a door or window is open the Pi and the positive rail on the breadboard 


Connect one end of the 
switch to the 3V3 pin on 
the Pi's GPIO 


A magnetic door security 
The other end of the switch is essentially 
switch is connected to a reed switch that’s 
physical pin 10 (BCM15) triggered by a magnet 


— like our diagram. Connect another to GPIO physical 
pin 10 (BCM 15) and the negative rail. You can then 
connect the magnetic switch to the positive and 
negative rails — it doesn’t matter which way here. 


You’ll need to create a Pushover app for this 

J Gel towork. There is a seven-day trial, and it’s 
$4.99 / £3.83 for a licence. Head over to pushover.net, 
log in, and then create an application. Give it a name 
(Door Monitor) and upload an icon — there’s one in our 
source code if you want to use that! You will then get 
an API Token / Key, and you can find your user token 
on the main screen. Keep these safe! 


THE CO 
¥*) ON MOTIONEYEOS 
Jw Unlike Raspbian, motionEyeOS does not 
allow you to clone GitHub repositories easily. The 
quickest way is to SSH into the Pi (usually as root) 
and then navigate to the /data/etc directory and type 
nano monitor_1. The file does not need an extension 
and the number has to match the camera ID it will 
work with. Now add our code, replace the app and user 
tokens for Pushover, then save and exit. Lastly, run 
chmod +x monitor_1 to make the script executable. 


STI CHECK IF IT 
i] By now, you should have prototype circuit, 
m a Pushover app, and have added our 
code to your Pi running motionEyeOS. If you have 
motionEyeOS open in your browser, reload the page 
first as this is required. Next, click on the image of the 
camera feed and you should see the word ‘Closed’ in 
the bottom-left corner of the screen. If you break the 
circuit — i.e. pull the magnet away from the switch - 
this should change to ‘Open’ and you should receive a 
Pushover notification. 


[TALL THE SWITCH PI ] 

Now that we know the switch and code work, 
Ww you can disassemble your prototype circuit 
and install it all properly. It’s worth powering off your 
Pi first, though. The magnet part of the switch should 
go on the door/window itself, and the switch part 
should be on the frame - there are normally installation 
instructions supplied with the switch as well as screws 
etc., for mounting correctly. Once complete, boot up the 
Pi and everything should be working properly. 


Outdoor Camera 


Our code displays a simple ‘Open’ or 
‘Closed’ message on the camera feed 


in motionEyeOS, as well as in the Pushover 


notifi 


cation. You can easily change this by 


modifying the relevant parts in our code. By 


defau 


It, and to prevent you from being spammed 


with repeated Pushover alerts, we’ve set our 


code 
cana 
time 


to run every 300 seconds (5 minutes). You 
so tweak this, but we found it to be a good 
period. 


1 


@ Unlocked 


70% 62% mm) wtlEe F 14:59 


Left In 
motionEyeOS, 
you can see the 
status of the door 
in the bottom- 
left corner when 
you click on 

the image - itis 
closed here 


Below You can also 
receive Pushover 
alerts when a door 
has been opened 

- handy for when 
you're not home! 


< Door Monitor Door Monitor 


®@ Door opened! 


The door is open! 


4:59 


aii ile 


PUSHOVER 
Door opened! 


The door is open! 


AMAZON DASH BUTTON 


Want to do more with the Amazon Dash Button apart from ordering shopping? 


Put it to good use and make your own IoT doorbell 


he Amazon Dash Button is a cheap, hackable 

internet-enabled device that was designed 

to order shopping online with a push. Whilst 
this is a great idea, why not make the Dash Button do 

a something more constructive by creating your very 
own IoT doorbell using Pushover notifications and 
a Raspberry Pi? In this guide, we’ll show you how to 
do exactly that so you can be alerted to visitors even 
e when you are away from home. 


Once pushed, the Dash 
Button triggers a Pushover 
notification on your 
smartphone or tablet 


The LED status light will 
pulse white when pushed 
- the red flash can safely 
be ignored 


The button can 

be simply stuck to 
the frame with the 
supplied adhesive 


Before you can use the Dash Button, 
you will need to start the process of setting 
up the button on Amazon. Follow the steps 
outlined here (amzn.to/2mNhAqt), but stop 
and exit the app before you choose the product. 
It’s important to do this otherwise you could 
rder products! Next, you’ll need to find the 
MAC address of your Dash Button — this is 
unique to your button and identifies it online. 
Read our previous tutorial on how to do this 
here: magpi.cc/2rwtTxP. 


ie} 


You’ll need to create a Pushover 

app for this to work. There is a 
seven-day trial, and it’s $4.99 / £3.83 fora 
licence. Head over to pushover.net, log in, 
and then create an application. Give ita name 
(Dash Doorbell) and upload an icon — there’s 
one in our source code if you want to use that! 
You will then get an API Token/Key, and you 
can find your user token on the main screen. 
Keep these safe! 


Clone our Python code from 
GitHub with: 


git clone https://github.com/ 
raspberrycoulis/dashdoorbell.git 


...and then you will need to make a few 
simple edits to get this up and running. 


Pushover — oro dashaccrbel py — -/gthub/dasndoorbell-gthub 


Dash button (Application) Bac 


API Token/Ke\ 


Yo begin i 


Subscription (cui s 


‘Ths application has ret ae 


to stow users to wubecrbe 
Licensing Credits (Purchas 1 Credits) 

Tis application dees nt have any loenaing eed 

Wo get stated with our to aelgn device Keenees to your urs, you ean 


Recent Usage (Upgrade 
‘20 messages have bean vont out of 7/600 


t You'll need 
to add your Dash 
Button’s MAC address 
and Pushover user 
and application 
tokens to the 
dashdoorbell.py 
script before it'll work 


Create your Pushover app and then grab your user and API token 
keys. Why not use our app icon in the source code? 


Alternatively, you can type the code yourself using 
your favourite code editor, but cloning is a lot quicker! 
Assuming you are in the dashdoorbell directory, run 


nano dashdoorbell1.py to edit the code, replacing Now everything is working, you can 
the MAC address, app and user tokens where shown, install your Dash Button wherever 
then exit (CTRL+X) and save (Y) to keep the changes. you want it. The button comes with an adhesive 


sticker on the bottom, so you can just use that to 
affix the button, but please keep in mind that this 
Before you affix your Dash Button to your is semi-permanent and also remember that Dash 


door frame, you might want to just check Buttons are not waterproof! You could also put it 
that everything works as it should. After you have on your bedroom door to stop your nosey parents, 
added your MAC address, app, and user tokens in sister, or brother coming in unannounced. 


the previous step, you can test the Python code 
by running sudo ./dashdoorbel11. py in the Pi’s 


Terminal. You won’t see anything in the printout, but The default message in our code is 
push the button once or twice and you should get a basic and just tells you that ‘There’s 
Pushover notification on your smartphone or tablet! somebody at the door!’ with the title ‘Doorbell’. 


However, if you want to you can easily change this 
to whatever you like by editing the relevant parts 


in the dashdoorbell.py code. Using the Pushover Why 

wie > @ Unlocked = 7 4 77%) wie = 13:28 ‘ not create your 
<Back Dash button API is very simple, and well documented over at ownllabel2 Just 
- = G & peel the old one 

13 a yal  naen pushover.net/api, but feel free to experiment. eae Tne 

$ There's somebody at the d You can even change the sound by changing the template in the 

Wednesday 18 3 “ source code to 

: vi appropriate part in the code! create your own 


If set up correctly, when you push 
the Dash Button you should receive 
a push notification that tells you 
somebody is at the door! 


Press Home to open 


Maker 

says 

An 
extremely 
compact 
industrial 
server based 
on Raspberry 
Pi Compute 


Module 
Sfera Labs 


STRATO PI CM 


et RATO PI OM 


STRATO PI CM 


Need a robust housing/motherboard for your Raspberry Pi Compute Module? 


Brian Corteil gives the Strato a spin 


he Strato PiCMisa 
housing/motherboard 
designed for all versions 
of the Raspberry Pi Compute 
Module (CM) and is from a line of 
industrial products for the Pi/CM 
from Sfera Labs. The Strato Pi CM 
can be supplied with or without a 
Compute Module. 

Designed for the loT market, it 
enables a Raspberry Pi to interface 
with industrial equipment/sensors 
to the internet. Possible roles 
for the Strato include collecting 
sensor/diagnostics data, as a web 
interface to the collected data, 
to bridge old equipment via its 
RS-485 port to the internet, and 
for a webcam CCTV network video 
recorder (NVR). 
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Opening the box, we found 
a standard two-gang DIN 
module that can be mounted to 
a DIN rail type normally used 
in electrical distribution boards 
and industrial control panels. 
The removable connector block 
is clearly labelled along with the 
LEDs on the front panel. On close 
inspection, the module has an 
RS-485 interface, two USB ports, 
and an Ethernet port. Other 
features include 9 to 28V DC 
power voltage, a real-time clock, 
controllable LED, and a hidden 
push-button. 

Obtaining access to the PCB 
proved very simple: you just need 
to remove the DIN rail retaining 
clip, power/RS-485 block and, 


using a small bladed screwdriver, 
the PCB is exposed. There are 

a couple of new interfaces: a 
micro USB port for programming 
the CM, and a microSD holder if 
you are using a CM Lite board and 
the hidden button. 

Your reviewer handed the 
Strato to friendly electronic 
engineer and fellow Makespace 
member Rob Karpinski for his 
view of the construction and 
design. Having given it a once- 
over, he said that it was well 
made and that the RS-485 inputs 
were well protected. When told 
the cost of the unit, he choked 
a little but did say that it was 
expected for a device designed for 
industrial use. 
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Sfera Labs sent the Strato Pi CM 
Solo for review; this version does 
not come with a CM, but installing 
one is easy: just line it up and push 
down until it clicks. The next step 
is to install Raspbian. Reading 
the included Quick Reference, we 
were pointed to the user guide 
on the Sfera Labs website and 
then instructed to follow the 
guide on the Raspberry Pi site - 
magpi.cc/UtAcOj. We followed the 
guide and used the micro USB port; 
the user guide did not mention that 
the Strato had to be powered at 
the same time to install Raspbian 
Stretch Lite on the CM eMMC. We 
remembered to include a file called 
ssh to enable remote access and 
then connected to the Strato via its 
Ethernet port using PuTTY. 
Following the user guide, we 
installed the Strato Pi utility and 
the software supporting the real- 


STRATO PI CM 


From £264 / $290 | 


test equipment box. Using PuTTY 
on the PC, we were able to access 
the CM’s console and use the 
command line as normal. With the 
correct cable, this means we could 
use the console or have sensors/ | 
equipment installed up to 1000 
metres away. 


os + 


Niche market 

The Strato Pi CM is for a niche 
market that requires the 
versatility of the Raspberry Pi in 
a small compact format that the 
Compute Module allows, and the 
professional user requires. The 
build quality is excellent and with 
a well-thought-out design. The 
inclusion of a real-time clock, 
isolated RS-485 serial interface, 
LED, and button, plus the wide 
range of voltages the Strato Pi 
can take for its power input, are 
its strengths. Adding all these 


The build quality is 
excellent and witha 
well-thought-out design 


time clock. We played around with 
the utility, turning on/off the LED, 
and restarting the CM using the 
watchdog feature — although it 
turns out you don’t need to use 
the utility to access these features 
or the button. 


Test script 

After installing the GPIO Zero 
Python library, we wrote a simple 
script to flash the LED every couple 
of seconds for ever. This script has 
now been running for over 14 days; 
the Strato module has been sitting 
in your reviewer’s garden office 

/ toy room, in temperatures over 
35°C with no issues. 

Next thing to test was the 
RS-485 serial port. Luckily, we 
had an RS-485 to RS-232 anda 
serial-to-USB converter in the 
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functions to a standard Pi would 
require the use of several HATs 
stacked on top of each other. Your 
reviewer would personally like to 
see some GPIO pins broken out 
from the Compute Module with 
the same protection as the RS-485 
port, to allow the adding of I?C, SPI 
devices, sensors, and extra LEDs 
and buttons. 


{ast word 


If you need the power of 
the Raspberry Pi 3 Compute 
Module in a compact industrial 


case with an RS-485 interface, 
we don't think you would go 
wrong with the Strato Pi CM. 


Right Why stack 
HATs when you 
can just use this? 
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Maker 
says 

A high- 
resolution, 
high-speed 
4,0” TFT 
display 

for your 
Raspberry Pi 


Pimoroni 


£A0 / $51 


HYPERPIXEL 4.0 


Rob Zwetsloot looks at this bigger touchscreen for your Pi that is still palm-sized 


OFFICIAL 
TOUCH 
DISPLAY 


Alarger screen 
at the same 
resolution as the 
HyperPixel 4.0, 
its size may 

be more 
attractive for 
some projects. 


£60 /$76 
magpi.cc/2mftBGX 


t was only last year that 

we reviewed the 3.5-inch 

HyperPixel from Pimoroni, 
itself a fantastic touchscreen 
offering great pixel density ina 
diminutive, Pi-sized form factor. 


work with the new HyperPixel. It’s 
an interesting dilemma as, due 

to the existence of stuff like the 

A+ and the Pi Zero, the standard 
Model B form factor is not as 
ubiquitous as it once was. If the old 


The screen is super-lovely once 
working — crisp and clear visuals 
thanks to the pixel density 


This new, bigger HyperPixel model 
keeps the same high-quality parts 
but gives you more screen real 
estate to work on. 


The larger size d 
doesn’t fit within 
the (standard) Ras 
factor, with a good 


screen hanging off 
of the board. It’s really not that bad, 


oes mean that it 
the confines of 
pberry Pi form 
chunk of the 
the SD card side 


but it does mean if 


you have any 


cases that previously allowed you to 
squeeze in the 3.5-inch HyperPixel 
or other displays, it likely won’t 
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3.5-inch screen would outsize a Pi 
Zero, then why not make it a little 
bit bigger anyway? 


One-line install 

As usual, this bit of Pimoroni kit 

is really simple to install. All you 
need to do is attach the screen 

to a Pi, hook the latter up to the 
usual monitor and keyboard 
arrangement before turning it 

on, and then enter a one-line 
command in the Terminal to get all 
the software properly installed. It 


doesn’t take long and you’ ll then 
be immediately ready to go! 

The screen is super-lovely once 
working — crisp and clear visuals 
thanks to the pixel density, with 
responsive touch controls and wide 
viewing angles due to the display 
tech used. It’s basically everything 
you’d want from a screen, and the 
Raspberry Pi can handle it just fine. 

If the touchscreen controls 
aren’t a necessity, you can get 
a HyperPixel without them and 
save a few quid (and probably a bit 
of power draw). Either way, it’s 
another top Pimoroni product. 
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A beautiful screen that’s easy 
to install with a responsive 
touchscreen perfectly suited 


for every Pi with 40-pin GPIO. 
What more could you ask for? 
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* WHY IT'S WoRTH 


he Raspberry Pi 

has helped create a 

new boom in hobby 
robotics, largely thanks to its 
price, easy hackability, size, 
and a great community willing 
to share their robot expertise. 
It’s never been easier to join in 
yourself, thanks to a plethora 
of robot kits for the Pi. Here 
are ten of the best, in no 
particular order. 


» 


. 
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RASPBERRY PI 
ROBOT KITS 


Make the perfect Raspberry Pi automaton 
with these excellent robot kits 


This fantastic, simple kit has been 
around for a while to promote Pi 
Wars, the annual Raspberry Pi 
robot challenge. It includes all 

the basic stuff you need to create 
a robot — all you need to do is 
supply your own Raspberry Pi! 
You can even use the box as the 
robot’s chassis. 


A more beginner-friendly PiBorg kit compared to 
the DiddyBorg, the YetiBorg is a smaller design that 
is perfect for people relatively confident in their 
coding skills who want to apply them to something 
physical. It’s also used in the Formula Pi racing 
series, where automated robots compete against 
each other using code from teams around the world. 


Cute biped 


This adorable robot may be 

on the expensive side, but it’s 

unusual for a Raspberry Pi robot 

as it walks. And waves at you. 

Construction is a bit tricky, 
and coding is trickier 

Q still, but once you have 

; it walking around 

and interacting 

with things, it’s all 

well worth it. 


While all the robot kits here can be made autonomous, 
this kit is one of the few that comes with all the 
equipment you’!l need to make it so from the start. It 
has a line sensor, an ultrasonic distance sensor, and 
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Tiny 4WD 


Competition ready 


This robot kit from maker Brian 
Corteil is based on a robot- 
building feature he wrote way 
back in The MagPi #51, improving 


upon the design and supplying it 
one complete box. It’s powerful, 
extremely quick, and very sturdy. 
Thanks to the Explorer pHAT 
motor controller, it’s also very 
flexible and can be modified to 
any of your requirements. 


While not a very mobile robot, the MeArm is a 
robot nonetheless, albeit more like one you’d 
find in a Peugeot factory signing Picasso cars. One 


Want to skip 
the kits and 
build a robot 
from scratch? 
Check out 
issue 51 of 
The MagPi for 
tips on what 
you need to 
make your 
own robo- 
companion: 
magpi.cc/51 


YouR oF zy 
FIC, 
iat SASPOERRY 6 ane» 
NE 


This great kit lets you control 
a robot out-of-the-box from 
an Android phone or browser. 


of the coolest things about the project is that it 
comes with a very neat joypad 
setup that fits on top of the 
Pi and controls the arm. 
: ; ; e- : 

With a bit of hacking, you a ff 7 
can probably repurpose it 
for something else as well. 


around. The kit is 
aimed at beginners 
and uses a webcam 
rather than the Pi 

_ “2 _camera Module. 
i, a 


While a lot of Raspberry Pi robot 
kits have an educational aspect to 
them, the GoPiGo goes one step 
further by not only offering an 
easy-to-use series of base kits for 
individuals, but also special kits 
with enough robots for an entire 
classroom. They’ 1] even help you get 
the right educational information. 


This very simple Pi robot looks like 
a Space Shuttle (hence the name 
STS, which was used for Space 
Shuttle mission numbers), giving 
it immediate cool factor. It’s 

a simple build with not much 
ability to be developed further 

as easily as other kits, but it’s 
great for beginners and especially 
younger makers. 
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The camera can even be tilted 
and panned to look 


ae 


DiddyBorg v2 


Serious robotics 


This beast of a kit from the robotics whizzes 

at PiBorg is powerful, sturdy, and endlessly 
upgradeable. It’s everything you’d want froma 
robot kit that you plan to use as a test platform, or 
as the base of a bigger, meaner build. There’s even 
a faster version called the Red Edition. 
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LED SHIM 


Maker 
days 


LED SHIM 38 4% 2. ¢°  <ePIMORONICOM ©” 


TATEDIENRUTRAGEST RAE EET ATE AGERE ESET RISE POETS PISE) 


28 tiny side. 2, clotoccbantectcohes: 
PAOMOMMOMMOIOOOOOOODOOOOOC028@008@8 
RGB LED 
pixels in a 
single row 
Pimoroni 


LED SHIM 


This slimline LED strip could give your Pi the (illuminated) edge, 
as Phil King discovers 


fter upping the pixel count Ata mere 0.8mm thick, the use-cases — such as a VU meter, 
on its Unicorn HAT and SHIM leaves plenty of roomontop Twitter status, and data display 
Scroll pHAT, Pimoroni to add a HAT or pHAT. And since — as well as some impressive 
has done a similar trick for its it only uses two [°C pins, there animated effects. 
Blinkt! LED strip, but this time it should be no pin conflict issues. There are also some examples 
comes in super-slim SHIM form. The LED strip protrudes from the of using the SHIM with other 
Packing 28 tiny RGB pixels - about edge so it’s still perfectly visible boards such as the Enviro pHAT - 


for which there’s a colour-coded 
direction meter and a spirit level. 


The SHIM leaves plenty of room Coding it is similar to on the 
Blinkt!, using a ‘set’ function to 
Olt top to add a HAT Or pHAT select a pixel’s RGB shade, then a 


‘show’ function to light it. So it’s 


half the size of the Pi’s own status with another board on top; the simple to start creating your own 
BLINKT! LEDs — the LED SHIM simply only downside is that you might lighting effects. 
eae slips onto the GPIO pins with no have trouble fitting the Pi in a case. 
RGB LEDs, the soldering required. The ‘friction 
original Blinkt! fit? keeps it in place, even when Bright and beautiful qast word 
feaiatans turned upside down. While it Arranged in a single row, and ; 
onto the GPIO. worked fine on most Piboards we driven by the same LED matrix Ideal for a status display, or 


some cool lighting effects on 
the edge of your Pi, this super- 


tried, we did have an issue witha chip used on the Scroll pHAT 
poor pin connection onone Pithat HD, the 28 LED pixels are tiny 
resulted in an I/O error. A bit of but bright. A one-line installer 
jiggling usually fixes the issue but | command adds the software 

if not, there’s always the optionof library anda host of examples 
soldering the SHIM to the GPIO or (magpi.cc/AoDrqc). The latter 
adding a female header. demonstrate numerous possible 


slim SHIM has numerous 
possible uses and can work 
with add-on boards on top. 


magpi.cc/tnbkRL 
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CoderDojo 


CanlIstarta 
CoderDojo club 
in my local area? 


CoderDojo is a global network of free, volunteer-led, project-based 
programming clubs for children aged 7-17. Dojos are championed by 
individuals all around the world who are passionate about giving young 

people the opportunity to learn to code. 


incredibly 
rewarding experience 


“| started a Dojo to give my kids a place to meet other children also 
interested in programming and making games. | get to see them 
making new friends, learning from one other, and they loved it. 
Realising how | had created such a wonderful place for children has 
ignited a spark in me.’ 

- Maroes, CoderDojo NL 


Start your own club. Join us at CoderDojo.com 


The CoderDojo Foundation is Irish Registered Charity (624255) CHY20812 oe R berry Pi 
and is part of the Raspberry Pi Foundation, UK registered charity 1129409 alse aspberry 
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£5-£20 / $7-27 
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Components 


and useful 
bits for 
everyday 
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and tech 


projects 
Pimoroni 
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PIMORONI 


Maker Essentials 


LEDs & Resistors 


MAKER ESSENTIALS 


A selection of neatly packaged parts for makers 


CAMJAM 
EDUKIT #2 


CamJam Edukit 
#2 comes 

with a larger 
breadboard, a 
range of LED 
lights and 
sensors, and 

an online set 

of detailed 
worksheets. 


a TA 


a 


£8/S11 
magpi.cc/IBortt 


ne of the coolest 

things about coding 

with a Raspberry 
Pi is its integration with 
electronic components. 
Every maker starts out by 
discovering how to set up the GPIO 
pins to a breadboard, and create 
simple circuits with LED lights, 
resistors, and switches. Typically 
the next step is building and 
controlling a robot from simple 
motors and wheels. 

There’s no shortage of starter 
guides on how to blink an LED with 
a Raspberry Pi, or use buttons to 
interact with code. But it’s often 
weirdly confusing for a beginner to 
get hold of components to go with 
online tutorials. 

Which is where Pimoroni 
hopes its Maker Essentials kits 
will step in. This collection of 
low-cost components offers a 
neat and simple way to get basic 
equipment without having to buy 
packs of parts from random eBay 
or Amazon sellers. 
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There are five different packs 
available: LEDs & Resistors (£5.50), 
Various Headers (£5.50), Mini 
Breadboard & Jumpy Jerky (£9.20), 
Switches & Potentiometers (£7.26), 
and Micro-motors and Grippy 
Wheels (£22). 


Quality components 

Each pack is sealed and contains a 
selection of the appropriate parts. 
Quality is high across the board, 
although some packs seem to make 
more sense than others to us. 

The collection of LEDs & 
Resistors is valuable for any 
beginner. The Mini Breadboard & 
Jumper Jerky would be a good pack, 
but one larger breadboard would be 
infinitely more practical than two 
mini boards. 

The Switches & Potentiometers 
is a useful pack of parts, but 
does anybody really need the 48 
headers in the Various Headers 
pack? (We’re sure folks will get in 
touch saying they can never have 
enough headers. ) 


Perhaps the most interesting 
pack is Micro-motors & Grippy 
Wheels, which offers a neat path 
to a micro robotics kit. The motors 
and wheels are dinky, but you'll 
need a motor controller (which 
you could get for the same price 
included in some other kits). 

We couldn’t find any online 
instructions for the kits. Given the 
simple nature of the components, 
that’s not a major issue: there’s 
no shortage of tutorials for any of 
them. Even so, beginners will be 
better served with a package that 
combines parts with instructions. 


{ast word 


These are neat packs of high- 
quality components that serve 
a simple purpose, but do it well. 


Total beginners should look to 
more comprehensive kits with 
project instructions, though. 
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RESOURCES 


LEARN PYTHON 


WITH RASPBERRY PI 


ADVENTURES IN RASPBERRY PI 


YOUTUBE 
VIDEOS 


The best Python YouTube sites 


eoeeccoce 


RASPBERRY PI 


The Official Raspberry Pi channel is 
packed with resources for learning 
to code, and almost all of them 
feature Python. You'll also find 
advice on setting up a Raspberry Pi, 
plus how to make awesome things 
with Raspberry Pi, Python, and 
electronics. Be sure to subscribe! 
youtu.be/QAHJVe2jq_E 


GEEK GURL DIARIES 


This fantastic website offers a crash 
course on computer science and 
programming by none other than 
Code Club's Carrie Anne Philbin. 

It covers a range of boards and 
technologies, but be sure to take a 
look at the Raspberry Pi tutorials. 
youtu.be/bZwubV-m9JM 
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LEARN PYTHON 


Amore advanced collection of video 
tutorials put together by Free Code 
Camp. This comprehensive course 
isn't Raspberry Pi specific, but covers 
everything from getting started with 
strings all the way up to objects 

and inheritance. 
youtu.be/rfscVSovtbw 
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New to Raspberry Pi? Want your 
children to learn coding and have 
fun connecting up lights, sensors, 
or even marshmallows? Or even 
use the Pi to make a dedicated 
device? You’ve come the right 
place. Philbin is a technology 
educator with plenty of experience 
of bringing alive the Pi’s 
possibilities for a young audience. 
After setting up the Pi, and 
learning some command-line 
basics, readers get to try using the 
Scratch programming language 

to animate a monkey sprite, then 
start building a role-playing 
game, before diving into turtle 
graphics to make shapes with 
both Scratch and Python. Sonic 

Pi continues the coding — making 


music with Ruby code. Throughout 
these divergent adventures, 
additional notes, definitions, and 
tips and tricks combine with the 
lessons to more broadly educate 
new programmers. 

The last chapters are on 
hardware: using the GPIO with 
those sensors and marshmallows, 
and building a Pi jukebox. 

Readers who already have the 
second edition (see The MagPi 
#32) will want to know what’s 
new — a whole extra chapter on 
experimenting with cameras, and 
expanding your Pi’s capabilities 
with add-on HATs — but won’t 
need any persuasion to buy extra 
copies as Christmas presents for 
young relatives! 


Author: 

Carrie Anne Philbin 
Publisher: 

Wiley 

Price: 

£20.99 

ISBN: 
978-1119269069 
magpi.cc/2zt24rO 


Carrio 
fo Anne Panes, 


TEACH YOUR KIDS TO CODE 


Dr Payne promises “programming 
so easy a parent can do it!” Starting 
with turtle graphics, the reader is 
drawn in, and Python seems natural, 
easy, yet still a thing of wonder. 
Learners are encouraged 
to experiment, rather than 
overloaded with details of how 
and why — but where details are 
necessary, such as number types 
and operators, they are introduced. 
As concepts are brought into 
play, we feed them into turtle 
graphics — so conditionals lead 
to fractal spirals, and user input 
selects the shape drawn. 
Programming challenges at 
the end of each chapter - turning 
the High Card game into War, or 
adding sound effects to the Pong 
game — steer further learning. 


Aimed at children aged nine 
and up, there’s enough here 
for everyone — parents can take 
younger children through some of 
the projects, and teens shouldn’t 
feel talked down to. 

Payne has the balance right 
between giving enough in plentiful, 
fun projects to keep interest, and 
introducing programming concepts 
to build real understanding almost 
by osmosis. 

Python and Pygame installation 
are banished to an appendix, where 
you’ ll also find instructions on 
creating your own modules! And 
once more, delightful illustrations 
by Miran Lipovaca lift an already 


excellent No Starch book to another 


level. Strongly recommended for 
learners of all ages. 


Author: 

Bryson Payne 

Publisher: 

No Starch 

Price: 

£19.99 

ISBN: 

978-1593276140 

magpi.cc/TYkZLo 
TEACH 

YOUR Kips 
DE 
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This could be the perfect 
introductory programming book to 
give to someone who’s just got a 
Raspberry Pi for Christmas. 

With no wasted words, Monk 
introduces the Pi and its operating 
system, then teaches both Python 
and using Python with the Pi, ina 
direct and easily absorbed text that 
harks back to the best beginner 
guides of the 8-bit era. 

Skip the first two dozen pages 
if you are not new to the Pi, 
and dive into Python with an 
introduction that — through 
well-chosen examples, such as 
a dice rolling simulation — will 
have you learning conditionals, 
control flow, and comparison 
operators before you know it. 
Next, Hangman introduces 


HEAD FIRST PYTHON 


Whether or not you like the quirky, 
visual style of O’Reilly’s Head 
First books, this is an excellent 
introduction to Python, well 
written and well paced. Aimed 

at those with at least a little 
coding experience in another 
language, Paul Barry’s text starts 
iconoclastically by sidestepping 
Hello World and diving into a 
more in-depth first program, 
bringing in the list data structure, 
importing from the standard 
library, and introducing the 
powerful in operator. 

The data-first approach, with 
lists, then dictionaries, tuples, 
and sets, is a firmer foundation 
than starting with control flows. 
Functions follow, and making 
your own modules, which you 
then install in the cloud at 
PythonAnywhere, to support the 
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LEARN PYTHON WITH RASPBERRY PI 


PROGRAMMING 
THE RASPBERRY PI 


functions, as well as strings, 
lists, and dictionaries. OOP is 
touched on with a temperature 
converter, then file handling and 
GUI programming (with Tkinter) 
through building on the earlier 
code examples. The Pygame 
chapter makes use of many of 
the techniques learned, then 
moves on to refactoring. 


INTERACTIVE 
WEBSITES 


Python web resources 


Author: 

Simon Monk 
Publisher: 

Tab Electronics 
Price: 

£11.64 / $15 

ISBN: 
978-1259587405 
magpi.cc/224fOlh 


Second Edition 


RASPBERRY Pl 


The Raspberry Pi Education section 
on the official website should be 
your first port of call when learning 


The same concise style is ogramming anything witha Raspberry Pi, and 
used to cover the Pi hardware the Raspberry Pi ae ates ne enon pereveul 
etting Started nd tutorials, blog posts, and 
for the rest of the book: with Python education resources. Sign up to 


GPIO pins, breadboard 
prototyping, connecting an 
Arduino, then a range of 
sample projects culminating 
in a Raspberry Pi robot. 
Unreservedly recommended 
for confident beginners of 
all ages. 


web app you write with Flask. 
Difficult subjects like decorators, 
comprehensions, and generators 
are painlessly introduced, as our 
app is constantly refactored, 
and communicating with an SQL 
database is carefully taught. 

PEP8 gets an early mention, but 
otherwise testing 
is left. Nor is there 
anything on Jupyter 
or doing data 
science, for example, 
but this is a book 
that teaches a lot, 
very quickly, and 
confident learners 
who find other 
introductory books 
too slow-paced will 
get a head start in : 
Python with this = 
Head First guide. Ziad 


& B simon Monk 


A Brain-Friendly Guide 


Head Firgt 


the Education Newsletter while 
you're there. 
rpf.io/ education 


FUTURE LEARN 


Raspberry Pi has teamed up with 
FutureLearn to provide interactive 
courses, most of which are in 
Python (and there's a great Scratch 


Author: to Python course). The courses 

Paul Barry are structured to last three to four 
Publisher: weeks and only require a few hours 
O'Reilly a week to learn. 

Price: rpf.io/online-training 

£39.99 Se ae 
ISBN: 


978-1491919538 


Learn Python 
magpi.cc/2nfiscb 4 


CODECADEMY 


One of the most popular coding 
sites around is Codecademy. Here 
you sign up and learn coding 
techniques in an interactive web 
environment. It's based ona 
‘gamification’ approach, so you 
get points and win awards for 
completing code missions. 
magpi.cc/ FUhUGy 
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£12.99 


200 pages of 


RASPBERRY PI 


PROJECTS BOOK 


VOLUME 3 


Amazing hacking and making projects 
from the makers of MdgPi magazine 
Inside: 

@ How to get started coding on Raspberry Pi 
@® The most inspirational community projects 
@® Essential tutorials, guides, and ideas 


@® Expert reviews and buying advice 


ai le @ 
Cie magpi.cc/store 


plus all good newsagents and: 


WHSmith BARNES&NOBLE 


4 Available on the GET IT ON 
@ App Store > Google Play 
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MAKER FAIRE 


We head to Tokyo to see what the Japanese Raspberry Pi 
community has been getting up to lately 


hen we say the Raspberry Pi is used all ; 

} ' Robots wandering the 
around the globe, we truly mean it. There FF = A show floor were common 
are thousands of Code Clubs and CoderDojos 

spread across the world and you’ll find Raspberry Pis 
everywhere on (and in some cases orbiting around) the 
Earth. The Japanese Raspberry Pi community is huge 
and, as we found out during our visit to Tokyo for Maker 
Faire, incredibly inventive. 


Stalls ranged from the 
very flashy to the very DIY 


This custom 
pinball machine 
was made up of 
old computer parts 


Korean 
projects also 
made an 
appearance, such 
as this cute line- 
following robot 
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Japanese pop culture 
was well represented 


87 
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I j UN i — ' : This LEGO Loo roll tweeted 


wl! a whenever you... used it 


There 
were amazing We saw more computer 


vision projects than ever 


selfie spots set 
up everywhere 


Baking is 
a classic form of 
making, and we 
especially loved 
these Raspberry 
Pi-shaped cookies 
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Flipping up the piano, you 


could see how it works 


Brother was showing off projects 
using conductive thread, like this piano 


Light-up balls for robot 
shooting helped with aiming 


LEGO was 
rare here, but used 
very well with Pi 


One of 
our favourite 
categories at 
Maker Faires is 
the agricultural 
products, and 
Tokyo did 
not disappoint 
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FEATURE 


AND 


In Tokyo’s Electric Town, you can 
find a Piin almost every store 


Components are 
neatly arranged in 
every store, filling 
up as much space 
as possible 


An old 
favourite of ours, 
Rapiro is still 
alive and kicking 
and you can 
buy them from 
Switch Science 


“t7F>K 
gaa 
ARETE) 


kihabara is one of the many areas that make 

up Tokyo, a loosely defined series of streets 

and shops in a sea of skyscrapers. Informally 
known as Electric Town, it’s more famous these days to 
people in the West as a centre of Japanese pop culture 
and nerd stuff. But among the Animate and Super 
Potato stores, maid cafes, and UFO arcades still lie the 
electronics shops of the past. 

Masafumi Ohta from the Japanese Raspberry Pi User 
Group showed us around Akihabara (or Akiba), pointing 
out all the interesting electronics shops. Row upon row 
of various components and electronics were lining the 
cramped shelves of the small stores, including sections 
dedicated to newer maker gear like the Raspberry Pi, 
Ichigo Jam, and Arduino. “You can also buy all of this 
online,” he assured us. 


Make the switch 


Earlier in the day we had taken a trip to Switch Science, 
an online supplier of Raspberry Pi and other maker 
goods in Japan. In Shinjuku, another area of Tokyo, 
Switch Science takes up a couple of offices where they 
ship out orders, make their own products, and create 
Japanese educational materials for young makers. 

“We saw a growing desire for educational materials 
among makers,” Yoshichika Yasui of Switch Science 
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One part store, one part 
makerspace, you could 
buy electronics and 
maker projects here 


told us. The office was a manic flurry of motion as 
orders were packed to be sent all over Japan, and even 
internationally. 


Education spaces 
Back in Akiba, Masafumi-san finally brought us to 
PCN’s flagship location. One part store and one part 
makerspace, here you could buy the ever popular Ichigo 
Jam. It’s a low-power, single-board PC in a similar 
vein to Raspberry Pi, albeit with a more basic control 
method. It uses a BASIC-esque programming interface, 
and school classes were free to come down and learn 
computing using it — in fact as we were talking, a 
retired teacher entered the store and proceeded to tell 
us how important this kind of education was. 

It’s also a general makerspace for people wanting 
to work on their projects in a communal setting — and 
there are plenty of projects to buy in the store and 
steps away in other electronics stores in the area. It’s 
a hugely popular resource for the local community it 
seems, and really highlights one of the general themes 
we saw while with the Tokyo maker community: 
everyone enjoys helping each other, and wants to make 
sure there’s a space to do so. 


The office was very busy making 
sure orders were shipped 
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CROWDFUND aaa 
THIS! Recah tate Berea Here are some other great 
m can crowdfund this month things we saw this month 


WHERE'S AI WALLY? 


AIR MONITOR & 
MULTIMEDIA KITS 


Another innovative product idea from Nanomesher, 
this time a multipurpose case and Pi kit that can be 
used as a weather station, video streamer, and music 
player depending on which version you get. It uses 
the great HATs already available from Nanomesher 


and lets you build them all into a custom-made Ever have to worry about cheating in your table football 
enclosure that offers more functionality than games? This ingenious Raspberry Pi system keeps 
previous Nanomesher kits. track of the score digitally, so no one can sneakily move 


counters across during the heat of a showdown in the 
centre of the table. 
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Protective Case for 
Raspberry Pi & Camera 


kck.st/2Mdm7TG 


PISHELL 


The PiShell seeks to fix an issue that you may find 
with many Raspberry Pi cases — while they’re great at 
protecting the Pi, you can’t always access the camera me ' 
port or even the GPIO pins. The PiShell comes in three Es - Ls 
parts: a base to set the Pi on; an intermediate step that 
lets you plug in the camera, use the DS] display port, 
and access the GPIO pins; and an easily removable lid 
that also has hole for the camera to peep through. It’s 
a great idea, and SB Components is well known for its 
excellent-quality gear. 


PASSIVE COOLING 


magpi.cc/wyQLij 
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EVENT CALENDAR 


Find out what community-organised, Raspberry 
Pi-themed events are happening near you... 


ROCHESTER ce Compe”. 7 
RASPBERRY JAM  ®— °SS°3Se, 0 e% 


gy 


4 SRVEF RASPBERRY PI JAM 


Want a Raspberry Jam in your ~ 
area? Want to start one? Email 


Ben Nuttall to find out more: 


ben@raspberrypi.org 


- ¢) DALLAS YOUNG 


MAKERS CLUB 


J7o REGULAR EVENTS 
RASPBERRY JAM FEN JAM CORNWALL TECH JAM 
CAMBRIDGE When: Sunday 23 September When: Saturday 8 September 


When: Saturday 15 September 
Where: Sancton Wood School 
Cambridge, UK 

magpi.cc/WxgdfB 

Not the usual CamJam, but a 
new Raspberry Jam run by the 
Cambridge Technology Academy. 


) 


ROCHESTER RASPBERRY 

PI JAM 

When: Saturday 22 September 

Where: University of Rochester, 
Rochester, NY, USA 

magpi.cc/niySeR 

Although aimed at youngsters, 

anyone with an interest in 

programming is welcome. 
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Where: Bluntisham Village 
Hall, Bluntisham, UK 

fenjam.org 

The first Fen Jam, with 

plenty of exciting things 

planned for fans of 

Raspberry Pi. 


SRVEF RASPBERRY PI JAM 
When: Saturday 29 September 
Where: BRITA, San Ramon, 

CA, USA 
magpi.cc/TycEuL 
Run by (a different) 
Imagineering team and 
providing students with the 
technical expertise they need. 


Where: Bodmin Library, 
Bodmin, UK 

cornwalltechjam.uk 

Learn about programming on 

platforms including Arduino 

and Raspberry Pi, ina whole 

variety of languages. 


HULL RASPBERRY 

PI JAM 

When: Saturday 15 September 

Where: University of Hull, 
Hull, UK 

magpi.cc/gRYMsi 

Share, learn, and tinker with 

digital making projects using 

Raspberry Pi. 
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K NORTHERN IRELAND 
‘ RASPBERRY JAM 


G HULL RASPBERRY PI JAM 


K .~2 a FEN JAM 
—J > 


RASPBERRY JAM 
8 CAMBRIDGE 


5 CORNWALL TECH JAM 


NORTHERN IRELAND 
RASPBERRY JAM 
When: Saturday 8 September 


Where: School of Maths and Physics 


Teaching, Belfast, UK 
magpi.cc/yNUGdg 


7 This free event involves tinkering, 


coding, electronics, and generally 
having fun making! 


DALLAS YOUNG 

MAKERS CLUB 

When: Saturday 22 September 

Where: J. Erik Jonsson Central 
Library, Dallas, TX, USA 

dallasyoungmakers.org 

Build a robot, make a computer, 

and create comics and books at 

the Dallas Young Makers Club. 
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WE'VE SOME OF 
THE AREAS 
CAN YOU HELP OUT? 


beg oS 
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We searched online for caterers in a 30-mile <a @ ae aw <4 | 
radius of the CamJam venue, and managed - @ OO 
to find someone who would attend free of M4 ° ~ 
charge. The venue is very convenient, for 
us and the attendees, and we know we can 
build food etc, into the ticket price. 
Michael Horne 
Cambridge Raspberry Jam 


a JAN « 


Every Raspberry Jam is entitled to apply for a 
Jam starter kit, which includes magazine issues, 
printed worksheets, stickers, flyers, and more. 
Get the guidebook here: magpi.cc/2q9DHfQ 
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LETTERS 


SUBSCRIPTIONS 


At the beginning of the year I had 
to cancel my subscription as I 
couldn’t quite afford it. However, 
I’m now able to subscribe again! I 
couldn’t find your three- and six- 
month subscriptions though; are 
they no longer available? 

Also, I was on a twelve-month 
subscription before and got my 
free Pi Zero W bundle with that, 
and I was wondering if I would get 
another bundle if I re-subscribed? 
I’d understand if it was just one 
per customer, though. 

Finally, do you get anything 
free with the rolling subscription? 
Lin 


That’s correct, we currently 
only offer the monthly rolling 
subscription and the year-long 


subscription. Any savings 
you’d have got with three or six 
months you get with the monthly 
subscription, and you can cancel 
that at any time! It also means you 
never miss an issue. 

As for free stuff, while you don’t 
get any special extra bundles like 
with the year-long sub, you still 
get all the free stuff that you’d get 
with the magazines anyway — such 
as any kits or posters we include in 
future issues. 

Also, the Pi Zero W bundle is not 
once per lifetime! Every time you 
take out or renew a twelve-month 
sub, you’ll get the bundle we offer. 
That may change at some point 
down the line, but currently there 
is no end date on that. 

Hope this helps! 


‘ 


TOYS TO LIFE 


do something like this with a 
wide variety of toys and the 
like. Usually the limitations 
involve whether or not you can 
actually interface with parts of 
the device (and some people just 
electronics that must be tend to replace them, such as old 
controllable with a Pi, andeven screens, anyway). If you can find 
then I do wonder if I could just space for parts, however, you can 
use the empty space in a toy to do whatever you want. 
add electronics. Some of our favourites include 
Has anyone ever done this? turning a toy car dashboard into 
Louis T a fully functional Out Run arcade 
machine, and turning a toucan 
toy for very small kids into a 
Google voice assistant. 


I was wondering if it was 
possible to use a Raspberry 
Pi to ‘hack’ a toy so that you 
can then control it or make it 
more functional with the Pi? 
There are some with simple 


There are a few limitations, but 


The Tomy Turnin’ Turbo Dashboard arcade 
we’ve seen plenty of people 


mod is one of our favourite recent Pi projects 
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YOUR LETTERS 


F | a = and then install anything. Make sure to use this exact 
FR M HE F RUM = Series of commands: 


sudo -i 


echo "deb http://goofy.zamia.org/repo- 
FFI INE V | E ai/raspbian/stretch/armhf/ ./" >/etc/apt/ 
sources.list.d/zamia-ai.list 


wget -qO - http://goofy.zamia.org/repo-ai/ 
raspbian/stretch/armhf/bofh.asc | sudo apt- 


The Raspberry Pi Forum is a hotbed of conversations key add - 
and problem-solving for the community - join in via 
raspberrypi.org/forums If you’re still having some problems, double- 


check your internet connection or use a fresh install 
1) ’m stuck trying toaddthe _ try to install the software it says of Raspbian. 


repository for the Zamia ‘not found’. 
WRITE TO US 


speech stuff from the new Please help! 


MagPi [Ed’s note: issue 72] and Lee 
can’t get it to work. Have you got something you'd like to say? 
; : 
I’ve typed the SAAB in You need to make sure you oer Gel rs touch via magpiarasiber yeLorg or on The Mase 
and when I press ENTER it says the entire sequence with sudo -i 


section of the forum at: raspberrypi.org/forums 
OK, but when I do an update and before trying to add the repository 


Connecting Raspberry Pi 
to FPGA through USB 


os. 
_ . 
ard wi 


* CON-FMC™ supports USB 3.0/2.0. 
* CON-FMC™ supports Ubuntu, CentOS, and Raspbian. 
* CON-FMC™ supports C/C++ API such as BfmRead() and BfmWrite(). —— 
* CON-FMC™ supports off-the-shelf FPGA board with FMC connector. 

* CON-FMC™ supports FIFO interface and AMBA AXI/AHB/APB buses. 


* CON-FMC™ supports CPU-to-FPGA offloading. F U T U R E 


For additional information contact at contact@future-ds.com or ns 
visit www.future-ds.com/CON-FMC Design Systems 
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CAN YOU HELP INSPIRE 
THE NEXT GENERATION & 


OF CODERS? 


Code Club is a network of volunteers and 
educators who run free coding clubs for 
young people aged 9-13. 


la! To find out more, join us at 


WIN! GP Fi Supply 
PI-HOLE 


NETWORK SECURITY BOXES! 


We reviewed the Pi-hole in issue 71 of The MagPi and 


gave it a four-star rating due to its ability to handle 
even the heaviest ad-laden websites, so it can 
keep your network very secure from bad ads. 


“Pi-hole is a device that allows 
you to block all of those annoying 
internet advertisements on any 
device and even in apps” 


has five of the boxes to give 


away, 
Enter now at magpi.cc/win magpi.cc/ZeOTqW 


Terms & Conditions 

Competition opens on 29 August 2018 and closes on 26 September 2018. Prize is offered to participants worldwide aged 13 or over, except employees of the 
Raspberry Pi Foundation, the prize supplier, their families or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering 
the competition, the winner consents to any publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from 
The MagPi magazine. We don't like spam: participants’ details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and 
no cash alternative will be offered. Winners will be contacted by email to arrange delivery. Any winners who have not responded 60 days after the initial email is sent 
will have their prize revoked. This promotion is in no way sponsored, endorsed or administered by, or associated with, Instagram or Facebook. 
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Column THE FINAL WoRD 


t was almost exactly four years ago 

when I was offered the chance to work 

at Raspberry Pi. I knew all the team very 
well, but I’d had hardly any involvement with the 
Pi itself, and wasn’t all that sure what they would 
want me to do; at that time, I was working as the 
manager of a software team, with no experience of 
hardware design. 

Fortunately, this was when software had started 
to move up the list of priorities at Raspberry Pi. 
Eben and I sat down on my first day and played with 
the vanilla LXDE desktop environment in Raspbian 
for 15 minutes or so, and he then asked me the 
fateful question: “So — do you think you can make 
it better?” 

With rather more confidence than I felt, I replied 
“of course!” I then spent the next week wondering 
just how long it was going to take before I was found 
out to be an impostor and shown the door. 


Ul experience 

To be fair, user interface design was something of 
which I had a lot of experience — I spent the first ten 
years of my career designing and implementing the 
user interfaces for a wide range of products, from 
mobile phones to medical equipment, so I knew 
what a good user interface was like. I could even 

see what changes needed to be made to transform 
the LXDE environment into one. But I didn’t havea 
clue how to do it — I’d barely used Linux, never mind 
programmed for it... 

As | said above, that was four years ago, and ’ve 
been hacking the Pi desktop about from that day on. 
Not all the changes I’ve made have been popular 
with everyone, but I think most people who use the 
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SIMON LONG 


Simon Long is a software engineer working for Raspberry Pi, 
responsible for the Raspberry Pi Desktop on both Raspbian 
and Debian. 


Simon Long talks about his experience of revamping the Raspberry Pi Desktop 


desktop feel it has improved over that time. My one 
overriding aim has been to try to make the Pi desktop 
into a product that I actually want to use myself; one 
that takes the good user interface design principles 
which we are used to in environments like macOS 
and Windows - ideas like consistency, attractive 


So — do you think you 
can make it better? 


fonts and icons, intuitive operation, everything 
behaving the way you expect without having to 
read the instructions — and sculpting the interface 
around them. 


Final polish 

In my experience, the main difference between 

the Linux desktop environment and those of its 
commercial competitors is the last 10%; the polishing 
you do once everything works. It’s not easy making 
something that works, and a lot of people, once they 
have created something and got it working, leave it 
and move onto creating something else. I’m really 
not great at creating things from scratch — and have 
nothing but admiration for those who are — but what 
I do enjoy doing is adding that last 10%; going from 
something that works, to something that works well 
and is a pleasure to use. 

Being at Raspberry Pi means I get to do that every 
day when I come to work. Every time I see a photo of 
a Pi running at a Jam, or ina classroom, anywhere in 
the world, and it’s using my desktop - the thrill from 
that never goes away. 
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CDP Studio is a development platform for industrial control systems, now coming with a free 
version for non-commercial use. The system can run on a Raspberry Pi, supports C++, open source 
libraries and has a large feature toolbox including GPIO, 12C and MQTT. Its built in GUI design tool 


and features lets you code less and do more. 


Free download on 


CDP Technologies AS 
Nedre Strandgate 29 

P.O. Box 144 

NO-6001 Alesund, Norway 


info@cdptech 


Tel: +47 990 80 900 


com 


www.cdpstudio.com 


CDPStudio 


THE Official 
RASPBERRY PI 
EGINNERS BOOK 


THE EASY WAY! 


Pi Zero W computer 


Official case with three covers 
USB and HDMI adapters 

8GB microSD card 

116-page beginner’s book 


MOOd SMANNIOAG Id ABASAdS VE TWIOidAO SAL 


The pocket-sized desktop computer! ____— g 
» pIZEROW | 


magpi.cc/store 


